POLITE ニュースサイトでは、外部システムから記事を自動投稿するための REST API を提供しています。本APIの利用は有料サービスです。ご利用にはAPIキーの発行が必要で、利用目的・想定トラフィックを事前に審査いたします。
料金プラン
| プラン | 月額（税込） | 月間投稿上限 | レート制限 | サポート |
|---|---|---|---|---|
| Starter | ¥9,800 | 500件 | 30 req/min | メール（平日） |
| Pro | ¥29,800 | 3,000件 | 60 req/min | メール（営業日24h以内） |
| Enterprise | 個別見積 | 無制限 | 個別設定 | Slack Connect + SLA |
※ 上限超過分は従量課金（¥30／件）。キー発行には本人確認と利用規約への同意が必要です。
お申し込み・お問い合わせ
APIキーの新規発行・プラン変更は、お問い合わせフォームまたはメール（[email protected]）までご連絡ください。審査後、3営業日以内にトークンを発行いたします。
ベースURL
https://polite.example/wp-json/polite/v1/認証
全てのリクエストに Authorization: Bearer <API_KEY> ヘッダを付与してください。APIキーは SHA-256 でハッシュ化して保存され、平文は発行時にのみ表示されます。
エンドポイント
記事作成 POST /posts
新規記事を投稿します。
リクエストボディ
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
title |
string | ○ | 記事タイトル（最大200字） |
content |
string | ○ | 本文HTML（wp_kses_post でサニタイズ） |
excerpt |
string | — | 抜粋。SEOメタディスクリプションに使用 |
status |
string | — | publish / draft / pending（既定: draft） |
category |
string / int | — | カテゴリ slug または ID |
tags |
string[] | — | タグ配列 |
breaking |
boolean | — | 速報フラグ |
hero |
boolean | — | トップ大見出しフラグ |
featured_media_url |
string (URL) | — | アイキャッチ画像URL。取り込んで自動設定 |
サンプルリクエスト
curl -X POST https://polite.example/wp-json/polite/v1/posts
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
"title": "記事タイトル",
"content": "<p>本文</p>",
"excerpt": "記事の要約（160字程度）",
"category": "politics",
"tags": ["国会", "予算"],
"status": "publish",
"breaking": false,
"hero": false
}'成功レスポンス (200)
{
"id": 123,
"status": "publish",
"permalink": "https://polite.example/archives/123",
"edit_url": "https://polite.example/wp-admin/post.php?action=edit&post=123",
"title": "記事タイトル"
}記事取得 GET /posts/:id
curl https://polite.example/wp-json/polite/v1/posts/123
-H "Authorization: Bearer YOUR_API_KEY"レート制限
契約プランに応じたレート制限が適用されます。上限超過時は 429 Too Many Requests を返却します。バーストではなく 1分あたりの平均リクエスト数で判定されます。
エラーコード
| HTTP | code | 意味 |
|---|---|---|
| 401 | polite_api_unauthorized |
Authorization ヘッダ欠落 |
| 401 | polite_api_invalid_key |
APIキー無効 |
| 403 | polite_api_revoked |
APIキーが無効化されている |
| 429 | polite_api_rate_limited |
レート上限到達 |
| 500 | polite_api_insert_failed |
記事作成に失敗 |
利用規約（抜粋）
- フェイクニュース・著作権侵害・差別的表現・未成年者の肖像を含む記事の投稿は禁止します。
- 投稿内容は編集部によりモニタリングされ、違反時は通告なく削除・APIキー無効化する場合があります。
- APIキーの第三者提供・再販は禁止します。
- 詳細は契約書および利用規約全文をご参照ください。