b2c-scapi-admin

SCAPI Admin API

標準の Admin API を通じて、バックエンド連携を構築したり、Commerce データを管理したりできます。 ストアフロントのフローには b2c-scapi-shopper スキルを使用してください。

ツールの選択

B2C MCP が利用可能な場合：

• 専用のタスクツールを優先してください。利用できない場合は、リソースまたは skills_read を通じて skill://mcp/b2c-mcp-scapi/SKILL.md を一度読み込み、その後 skillRead: true を指定してください。
• scapi_search：標準の契約をオフラインでまとめて検索します。メソッド／パス／operationId を探し、選択したパラメーター、フィールド、セキュリティスコープを確認してください。簡潔な投影を返します。
• scapi_execute：設定済みの Account Manager 認証と自動的な操作／テナントスコープを使用して、サポート対象の Admin JSON 操作を実行します。マスキングを有効にして config_inspect を使用してください。これらの呼び出しでは、トークンを手動で取得したり、出力したりしないでください。
• scapi_schemas_list：カスタム属性や API を含む、テナントのライブスキーマを取得します。scapi_custom_apis_get_status：カスタム登録の状態を確認します。コードモードではカスタム実行とバイナリ転送はサポートされていません。適切な連携クライアントを使用してください。
• docs_search／docs_read：プラットフォームの仕様、制限、認証設定を確認します。見つかった契約を繰り返すだけのために、ドキュメントを重複して検索する必要はありません。

CLI／連携機能の開発では、b2c scapi schemas list と b2c scapi schemas get <family> <name> <version> でライブ契約を取得できます。 外部クライアント、トークンフロー、または一括インポートを実装する場合に限り、連携例を参照してください。CLI にコードモードと同等の機能はありません。

慎重に実行する

• 設定済みのショートコード、テナント、サイトの値を使用してください。Admin 認証には Account Manager クライアント、API 許可、および SALESFORCE_COMMERCE_API:<tenant_id> が必要です。 SLAS 認証情報で Admin 認証情報を代用することはできません。
• 使用前に操作を確認してください。例は参考用です。テナント固有のフィールドにはライブスキーマを使用してください。バージョン固有の仕様については、公式ドキュメントを確認してください。
• 作成と更新を区別してください。PUT はどちらも行う場合があります。存在と意図を確認してから、重要なフィールドを読み戻してください。失敗を再試行する前に、先行する書き込みを確認してください。
• API 側でページネーション／フィルタリングを行い、ID、選択したフィールド、合計数／hasMore、エラーを返してください。レスポンスツリー全体を出力したり、認証情報をログに記録したりしないでください。
• 安全性はメソッドに基づきます。POST による検索にも、対象を絞った許可ルールが必要な場合があります。確認が必要なコードモードのリクエストは停止してください。回避してはいけません。

条件付きで参照する資料

• OAuth スコープ：連携に必要な許可です。操作の security と照らし合わせてください。
• 連携パターン：ETL、同期、一括インポート。
• b2c-config スキル：CLI の認証情報と優先順位。
• 公式ドキュメント：commerce-api/authorization-for-admin-apis、commerce-api/auth-z-scope-catalog、 commerce-api/timeouts-limits、commerce-api/throttle-rates、 commerce-api/inventory-impex-best-practices。