reseller

PUT /v1/reseller/lines

Turn product lines on or off for your clients.

Minden reseller végpont

Hitelesítés

Küldjön egy API-kulcsot bearer tokenként. A kulcsnak rendelkeznie kell a(z) reseller.manage jogosultsággal; az ezzel nem rendelkező kulcsok esetén a rendszer 403-as hibát ad vissza 404 helyett.

A szervezet azonosítójának helye

Ez a végpont a(z) org_id paramétert lekérdezési paraméterként várja. Hagyja ki, ha a hívás az Ön teljes bérlői részfáját lefedje; küldje el a hívás egyetlen szervezetre történő szűkítéséhez.

A szervezeted azonosítója a vezérlőpult API-kulcsok képernyőjén található, közvetlenül a kulcs mellett. Ez ugyanaz az azonosító minden indított hívásban.

Próbálja ki

Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.

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

Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban

Részletek

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`.

Paraméterek

NévTípusKötelezőMi ez
org_id (query)UuidNemWhich 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…

Kérés törzse

NévTípusKötelezőMi ez
disabledstring[]IgenThe 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.

Válasz

NévTípusKötelezőMi ez
dataResellerLine[]Igen

Hibák, amelyeket ez a végpont visszaadhattatlan

401 · 403 · 404 · 422 · 429