hosting

POST /v1/sites/{siteId}/sitemap

Start a sitemap crawl.

Sve hosting krajnje tačke

Autentifikacija

Pošaljite API ključ kao bearer token. Ključ mora imati dozvolu sites.panel_access; ključ bez nje se odbija sa 403, a ne sa 404.

Ovaj krajnji tačka ne prihvata ID organizacije. Vaš ključ već identifikuje organizaciju kojoj pripada, a odgovor je ograničen na nju.

Isprobajte

Zamenite bilo šta u uglastim zagradama sopstvenim vrednostima, a ključni placeholder sa ključem sa vaše kontrolne table.

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

Prijavljeni ste? API konzola na vašoj kontrolnoj tabli automatski popunjava ID vaše stvarne organizacije i vaš sopstveni ključ, i izvršava zahtev nad API-jem uživo tako da možete videti stvarni odgovor. Otvorite ovu krajnju tačku u API konzoli

Detalji

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

Parametri

NazivVrstaObaveznoŠta je ovo
siteId (path)UuidDaSite ID (UUIDv7).

Telo zahteva

NazivVrstaObaveznoŠta je ovo
frequencystring<always, hourly, daily, weekly, monthly, never, yearly>NeThe `changefreq` written into the generated XML. A guideline to search engines, not a guarantee.
uploadbooleanNeOverwrite `sitemap.xml` in the webspace when the crawl finishes.

Odgovor

NazivVrstaObaveznoŠta je ovo
ever_runbooleanDaHas a crawl ever been run for this site?
runningbooleanDaIs 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.
statestringDaThe vendor's own job state, verbatim. Empty when none has run.
created_atstringDaWhen the most recent crawl started. Empty when none has run.
outputstringDaThe crawler's own output, if it produced any.
uploadbooleanDaWhether the crawl writes `sitemap.xml` into the webspace.
frequenciesstring[]DaThe change frequencies this site's crawler accepts.

Greške koje ovaj krajnji tačka može da vrati

401 · 403 · 404 · 422 · 429 · 503