Developer API v1（準備中）

未公開です。外部クライアントへの資格情報発行と production 利用申請は開始していません。現在の API は既定で HTTP 503 を返します。このページは契約の確認用です。

仕様正本: FG3-SPEC-004.1、§18.4〜18.7。許可済みの商品発見、媒体申請、集計利用を想定します。無断転載、権利未確認媒体、審査回避、他テナントの照会、公開投稿の直接実行は禁止します。

環境・認証・scope

審査済み sandbox client に限り OAuth 2.0 Client Credentials を使用します。scope は用途ごとに最小化し、tenant と環境を越えて使えません。production 資格情報は別審査です。実装済み経路と scope は以下のとおりです。

Webhook の申請は webhooks.manage で PENDING として受け付けます。申請元だけが HOST_APPROVED または REJECTED の審査状態を照会できます。HOST_APPROVED も配信先の有効化ではなく、運営管理の署名鍵と別の設定が必要です。審査済み配信先の読取と所有クライアントによる失効は提供しますが、外部からの有効化・鍵切替は未提供です。権利根拠の参照 ID は未検証として受け付け、申請者は権利を自己承認できません。配信状態の経路は申請元に対する private な審査申請受付と独立した内部審査結果だけを返し、実配信は未実装です。商品読取は承認済みの公開項目だけを返し、店舗名はテナント対応と公開プロフィールの内部審査後だけ返し、クリエイター表示名は明示的な同意審査と表示名の一致後だけ返します。未掲載の経路は提供していません。全 request/response schema と status code は OpenAPI JSON を参照してください。

Quick start（将来の sandbox 用）

以下は資格情報が正式発行された後の例です。現時点では実行できません。値は合成のプレースホルダーです。

curl

curl -u "$FG3_CLIENT_ID:$FG3_CLIENT_SECRET" -d 'grant_type=client_credentials&scope=discovery.read' https://api-test.fullgear3.com/api/developer/oauth/token

TypeScript

const response = await fetch("https://api-test.fullgear3.com/api/developer/v1/discovery/items?tenant_id=TENANT_ID&region=JP", { headers: { Authorization: `Bearer ${token}` } });
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);

Python

from urllib.request import Request, urlopen
request = Request("https://api-test.fullgear3.com/api/developer/v1/discovery/items?tenant_id=TENANT_ID&region=JP", headers={"Authorization": f"Bearer {token}"})
with urlopen(request) as response:
    body = response.read()

データ、審査、Webhook

既存の読取経路は承認済み媒体と権利証拠を絞り、媒体申請は公開承認を意味しません。申請元クライアントだけが private 状態と権利審査結果を参照できます。権利根拠の参照 ID は未検証として記録し、確認記録は内部レビューに限るため申請者は承認できません。Discovery 審査申請は現在の権利確認後に受付状態を記録します。独立した sandbox 内部審査の結果は申請元だけに private な REVIEW_ACCEPTED_PRIVATE または REVIEW_REJECTED_PRIVATE として返し、実配信・公開へは遷移しません。aggregate analytics は許可目的と地域で絞ります。帰属イベントは内部審査済みの campaign、creative、placement、同意参照に限定して未検証として受信し、売上や集計に加算しません。署名 Webhook は非公開ソースで部分実装ですが、実鍵・実送信と private E2E は未受入れです。synthetic media の公開可否は別の審査対象です。公開投稿は別リリースゲートで、既定で無効です。

共通プロトコル

v1 は URL で major version を固定します。Discovery 一覧は最大50件の cursor pagination です。副作用を持つ媒体申請・Discovery 審査申請・帰属イベント・Webhook 申請 POST と Webhook 失効 DELETE は Idempotency-Key が必須です。sandbox の暫定制限は client 全体120件/分、client・tenant・scope・endpoint別60件/分です。審査済み client の認証秘密値を繰り返し誤ると、その分の token 発行を制限します。429 は Retry-After を返します。エラー本文は code、retryable、request_id、安全な detail を含みます。

運用・利用条件

現在の status は「未公開」です。changelog: v1 契約案（2026-11-11）。deprecation と sunset の予定はありません。breaking change は新 major と移行手順で通知します。保持・削除、利用許諾、セキュリティ報告は公開前に審査します。プライバシー、利用規約、データ削除、セキュリティ方針、サポートを参照してください。

production 申請には sandbox の権限・テナント分離・rate limit・冪等性・モデレーション迂回拒否・署名 Webhook の private E2E 合格が必要です。公開投稿には法務、セキュリティ、モデレーション、運用、取消手順の別判定が必要です。