Partner API

API キー、グループ、制限、リクエスト履歴、非同期結果を 10 進数文字列アカウンティングで自動化します。

Partner API

Partner API は、銀行、ボット、再販業者パネル、内部プロビジョニングシステム、およびその他の信頼できるサーバー間統合を対象としています。バージョン 10.5.0 は、最初の銀行対応マシン契約です。

ベースURL

https://p-api.model-gate.com

認証

Authorization: Bearer mg_partner_...

すべての応答は JSON です。 404、 405、 429、そして 500、および含まれます X-Request-ID。応答の使用 Cache-Control: no-store;パートナーホストはブラウザ PHP セッションを使用しません。すべての外部タイムスタンプは UTC RFC3339 (YYYY-MM-DDTHH:MM:SSZ）。

全て POST、 PATCH、そして DELETE 操作には一意の操作が必要です Idempotency-Key ヘッダ。 Model Gate は暗号化された結果を 7 日間保持するため、同じリクエストを再試行すると、ミューテーションを再度実行することなく元の結果が返されます。別のメソッド/パス/本体で同じキーを再利用すると、HTTP が返されます。 409。

パートナーのリクエストは、アカウントレベルで構成された 1 分あたりのレート制限によって保護されます。 PARTNER_API_RATE_LIMIT_PER_MINUTE （デフォルト 600）。応答には次のものが含まれます X-RateLimit-Limit、 X-RateLimit-Remaining、そして X-RateLimit-Reset; HTTP 429 も含まれます Retry-After。

Model Gate プロファイルで Partner API キーを作成または再生成します。完全なベアラートークンは生成/ローテーション時に 1 回だけ表示され、Model Gate はその SHA-256 ハッシュと表示プレフィックスのみを保存します。トークンをサーバー側のシークレットマネージャーにすぐに保存します。紛失した場合は回転させてください。

プロフィールには別途あります API IP 許可リスト。空でない場合、Partner API リクエストは、許可された正確な IPv4/IPv6 アドレスまたは CIDR プレフィックスから発信される必要があります。個人ルールに加えて、ビジネス組織の API ルールも適用されます。いずれかの有効なホワイトリストによって拒否されたソースは HTTP を受信します 403 と error.type = ip_not_allowed。

ビジネスアカウントの場合、Partner API 資格情報は、認証された組織の所有者のみが使用できます。従業員プリンシパルと委任されたビジネス資格情報の割り当ては Web パネルで管理され、グループの実行権限を検証できます。したがって、パートナーが作成したビジネスキーは、所有者を請求所有者と資格情報プリンシパルの両方として使用します。付属の group_id アカウントが所有するアクティブなグループに名前を付ける必要があります。不明または凍結されたグループが HTTP で拒否される 422 グループ化されていないキーをサイレントに作成する代わりに。

10 進数値

財務フィールドと使用状況フィールドは常に JSON 文字列です。

{
  "spend_limit": "100.0000000000",
  "usage": "12.3456789000",
  "remaining": "87.6543211000",
  "usage_price_multiplier": "0.900000"
}

任意精度の 10 進数演算を使用します。これらの値を絶対に変換しないでください。 float。

能力

API キーを作成、一覧表示、更新、回転、凍結、凍結解除、削除します。
キーごとの使用量の評価を構成します。
グループを作成および管理します。
グループ間でキーを移動します。
キーとグループの使用法を読み取ります。
1 ～ 100 行ページとトークン/価格の内訳を含む、キーの最終リクエスト履歴を終了時間順に読み取ります。詳細なリクエスト履歴はホット保持されます。 API_REQUESTS_HOT_RETENTION_DAYS (デフォルトは 7 日);長期的な財務調整では、残高取引仕訳帳が使用されます。
カーソルのページネーションを使用して、当座預金残高と口座残高トランザクションを読み取ります。
カーソルのページネーションを使用してパートナー管理監査イベントを読み取ります。
非同期推論結果をポーリングします。

見る Partner API 個のすべてのエンドポイントリクエストとレスポンスの完全な例については、こちらをご覧ください。

最近のリクエスト履歴レコードには次のものが含まれます。 principal_user_id 会社の請求所有者とは別に、資格情報のプリンシパルがまだ存在する場合。

機械可読契約書

OpenAPI 3.1 コントラクトは、各リリースに次のように同梱されています。 resources/contracts/partner-api.openapi.yaml。これら Partner API ページとともに銀行統合契約として扱います。不明な JSON フィールドと不明なクエリパラメーターは、黙って無視されるのではなく拒否されます。