reseller

GET `/v1/reseller/services`

Everything you have provisioned for your clients.

אימות

שלחו מפתח API כאסימון נושא (bearer token). על המפתח לכלול את הרשאה reseller.view; מפתח שאינו כולל אותה יידחה בסטטוס 403, ולא 404.

המקום שבו מזהה הארגון שלך נכנס

נקודת קצה זו מקבלת את org_id כפרמטר שאילתת חיפוש. השאר אותו ריק והקריאה תכסה את כל תת-עץ הדיירות שלך; שלח אותו כדי לצמצם את הקריאה לארגון אחד.

מזהה הארגון שלך נמצא במסוף מפתחות ה-API בלוח הבקרה שלך, לצד המפתח עצמו. זהו אותו מזהה בכל קריאה שאתה מבצע.

נסה זאת

החלף כל דבר בסוגריים זוויתיים בערכים משלך, ואת מציין מיקום המפתח במפתח מלוח הבקרה שלך.

curl -X GET https://api.zinndigital.com/v1/reseller/services \
  -H "Authorization: Bearer zdk_live_…"

מחובר? קונסולת ה-API בלוח הבקרה שלך מזינה את מזהה הארגון האמיתי שלך ואת המפתח שלך, ומריצה את הבקשה מול ה-API הפיזי כך שתוכל לראות את התגובה בפועל. פתח נקודת קצה זו במסוף ה-API

פרטים

One row per site across your client subtree — the client organization it belongs to, its plan, its lifecycle status, its disk and bandwidth usage, and the price *you* charge for it. This is the endpoint a billing panel polls to keep its own records in step with ours, and it is the answer to "what have I actually sold". Cursor-paginated. Requires `reseller.view`. Sites in your OWN organization are excluded: this surface is about what you resell, and mixing your own estate into it would make a billing panel invoice you for your own sites.

פרמטרים

שם	סוג	נדרש	מה זה
`cursor (query)`	`string`	לא	Opaque cursor from a previous page's `page.next_cursor`.
`limit (query)`	`integer`	לא	Maximum items to return (page size).
`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…
`client_org_id (query)`	`Uuid`	לא	Narrow to one client organization.
`status (query)`	`SiteStatus`	לא	Narrow to one site status.

תשובה

שם	סוג	נדרש	מה זה
`data`	`ResellerService[]`	כן	—
`page`	`PageMeta`	כן	—

שגיאות שנקודה קצה זו עשויה להחזיר

401 · 403 · 404 · 429