hosting

POST /v1/sites/{siteId}/sitemap

Start a sitemap crawl.

Dhammaan hosting bixiyayaasha

Xaqiijinta aqoonsiga

U dir furaha API ah calaamad dusha ah (bearer token). Furaha waa inuu wataa ruqadda sites.panel_access; furaha aan wadan waxaa loo diidayaa 403, ee ma aha 404.

Boggan ma qaato aqoonsiga ururka. Furahaagu wuxuu horay u aqoonsanayaa ururka uu ka tirsan yahay, jawaabtuna waxay ku kooban tahay halkaas.

Isku day

Ku beddel wax kasta oo ku dhex jira qeebaha xaglaha ah qiimayaashaada, sidoo kalena haystaaha furaha ku beddel fure ka dhex muuqda dashboordigaaga.

curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/sitemap \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Ma sign-garaysay? Qalabka API ee ku jira dashboard-kaagu wuxuu buuxiyaa aqoonsigaaga ururka ee dhabta ah iyo furahaaga gaarka ah, wuxuuna ku shaqeysiiyaa codsiga API-ga nool si aad u aragto jawaabta dhabta ah. Kani ka fur barta kontoroolka ee API

Details

⛔ **`202`, and the returned state describes a job that has STARTED.** A crawler walks the whole site and may take minutes; the sitemap does not exist when this returns. Poll `getSiteSitemap` until `running` is false. Answering `200` here would be the status-code equivalent of telling the customer their sitemap is ready. `upload` writes `sitemap.xml` into the webspace, overwriting any existing file. Requires `sites.panel_access`.

Cabiraha

MagacaNoocLoo baahan yahayMaxay tahay
siteId (path)UuidHaaSite ID (UUIDv7).

Codsiga jidhkiisa

MagacaNoocLoo baahan yahayMaxay tahay
frequencystring<always, hourly, daily, weekly, monthly, never, yearly>MayaThe `changefreq` written into the generated XML. A guideline to search engines, not a guarantee.
uploadbooleanMayaOverwrite `sitemap.xml` in the webspace when the crawl finishes.

Jawaab

MagacaNoocLoo baahan yahayMaxay tahay
ever_runbooleanHaaHas a crawl ever been run for this site?
runningbooleanHaaIs a crawl in progress? ⛔ Computed as *not in a terminal state*, so a state we have never seen reads as still working rather than as finished.
statestringHaaThe vendor's own job state, verbatim. Empty when none has run.
created_atstringHaaWhen the most recent crawl started. Empty when none has run.
outputstringHaaThe crawler's own output, if it produced any.
uploadbooleanHaaWhether the crawl writes `sitemap.xml` into the webspace.
frequenciesstring[]HaaThe change frequencies this site's crawler accepts.

Cilladaha ay bartaani soo celin karto

401 · 403 · 404 · 422 · 429 · 503