hosting

GET `/v1/wordpress/sites`

List every WordPress site the caller owns, across all product lines.

Tabbatar da Asali

Aika maɓallin API azaman alamar ɗauka (bearer token). Dole ne maɓallin ya kasance yana da izinin sites.view; idan babu shi, za a ƙi amfani da maɓallin tare da lambar 403, ba 404 ba.

Inda ID ɗin kungiyar ku ke zuwa

Wannan mahadar ta na daukar org_id a matsayin sigar tambaya. Bar shi kuma kiran zai shafi daukacin rukunin haya naka; aika shi don takaita kiran zuwa kungiya daya tak.

Ana samun lambar kungiyar ku a kan shafin maɓallan API a cikin madanninku, kusa da maɓallin kansa. Shi ne lambar da ta dace a kowane kiran da kuka yi.

Gwada

May gurbin komai da ke cikin kusurwa da ƙimar ka, kuma may gurbin maballi da maballi daga allon sarrafa ka.

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

An shiga? Na'urar sarrafa API da ke cikin sashin kulawarka tana cika ainihin lambar ƙungiyarka da maɓallinka naka, sannan tana gudanar da buƙatar a kan ainihin API don haka zaka iya ganin amsar gaske. Buɗe wannan tashar a cikin na'urar kula da API

Bayani

The fleet manager's list: every `wordpress` or `woocommerce` site in the caller's tenancy subtree, on every product line and every deploy target (own fleet, managed shared, managed cloud, CloudLinux), with each one's stored WordPress posture. ⛔ **This endpoint never calls a vendor**, however stale a row is. Collecting is `refreshWordPressSite`, an explicit act; a row that has never been collected reports `update_state: unknown` with a null `snapshot`, and the client renders that as *"not checked yet"* — **never** as "up to date". Those are different sentences and a customer acts differently on each. `update_state` and `needs_attention` are applied **after** pagination, because the state is derived from four snapshot columns with an explicit precedence and re-expressing that precedence in SQL would give this list and `getWordPressFleetOverview` two implementations of one rule. A filtered page can therefore be short; the totals come from the overview, which counts everything. Requires `sites.view`.

Sigogi

Suna	Nau'i	Ana buƙata	Abin da yake
`cursor (query)`	`string`	A'a	Opaque cursor from a previous page's `page.next_cursor`.
`limit (query)`	`integer`	A'a	Maximum items to return (page size).
`org_id (query)`	`string`	A'a	Narrow to one organisation in the caller's subtree. Equivalent to the `X-Zinn-Org` header, which is now read centrally for every org-scoped operation — this parameter wins where…
`q (query)`	`string`	A'a	Substring match on the primary domain.
`product_line (query)`	`string`	A'a	—
`deploy_target (query)`	`string`	A'a	—
`update_state (query)`	`WordPressUpdateState`	A'a	`422` on an unrecognised value rather than silently returning everything — a filter that quietly does nothing is how a customer concludes their estate is clean.
`needs_attention (query)`	`boolean`	A'a	Only sites with a core or component update waiting, no WordPress installed, or a homepage that is not answering.
`health (query)`	`string<, healthy, unhealthy>`	A'a	Filter by the stored health verdict. ⭐ Applied in the database, unlike `update_state` — `health_status` is one indexed column written by one function, so there is no precede…

Martani

Suna	Nau'i	Ana buƙata	Abin da yake
`data`	`WordPressFleetSite[]`	Eh	—
`page`	`PageMeta`	Eh	—

Kuskuren da wannan matsaya za ta iya maido wa

401 · 403 · 422 · 429