reseller

PUT `/v1/reseller/lines`

Turn product lines on or off for your clients.

すべての reseller エンドポイント

認証

ベアラートークンとして API キーを送信します。キーには reseller.manage 権限が付与されている必要があります。権限のないキーは 404 ではなく 403 で拒否されます。

組織 ID を入力する場所

このエンドポイントはクエリパラメータとして org_id を受け取ります。省略した場合はテナントサブツリー全体が対象になり、指定した場合は特定の組織のみに絞り込まれます。

組織IDは、ダッシュボードのAPIキー画面にキーのすぐ横に表示されています。これは、実行するすべての呼び出しで同じIDになります。

試してみる

アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。

curl -X PUT https://api.zinndigital.com/v1/reseller/lines \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "disabled": <string[]> }'

ログインしていますか？ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 API コンソールでこのエンドポイントを開く

詳細

Send the complete set of line codes you are turning **off**; anything not listed is on. A line that is off cannot be bought by your clients through any route — it is hidden from their catalogue and refused at the basket, not merely unadvertised. Clients already on a plan in that line keep it and keep renewing; only new orders are refused. You cannot turn off every line at once — ask us to pause your programme instead. Requires `reseller.manage`.

パラメータ

名前	タイプ	必須	これがその内容です
`org_id (query)`	`Uuid`	いいえ	Which of your organizations this applies to. Required only when you belong to more than one here — otherwise it is inferred, and an id outside your direct memberships is a 404 r…

リクエスト本文

名前	タイプ	必須	これがその内容です
`disabled`	`string[]`	はい	The complete set of product-line codes to turn OFF. Anything absent is on. A replacing set rather than a patch, so the last save is the truth.

返信

名前	タイプ	必須	これがその内容です
`data`	`ResellerLine[]`	はい	—

このエンドポイントが返すエラー

401 · 403 · 404 · 422 · 429