hosting

POST /v1/sites/{siteId}/sitemap

Start a sitemap crawl.

Бүх hosting төгсгөлийн цэгүүд

Баталгаажуулалт

API түлхүүрийг bearer token хэлбэрээр илгөэнэ үү. Түлхүүр нь sites.panel_access эрхтэй байх ёстой бөгөөд үүнгүйгээр 404 биш, харин 403 алдаа буцааж татгалзах болно.

Энэ төгсгөл цэг нь ямар ч байгууллагын ID шаардахгүй. Таны түлхүүр аль хэдийн харьяалагдах байгууллагыг тодорхойлж байгаа бөгөөд хариу нь тухайн байгууллагын хүрээнд хязгаарлагдана.

Туршиж үзэх

Өнцөг хаалтанд байгаа бүх зүйлийг өөрийн утгаар солиж, түлхүүр санамж байрлуулагчийг хяналтын самбарынхаа түлхүүрээр сольж оруулна уу.

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

Та нэвтэрсэн байна уу? Таны хяналтын самбар дахь API консол нь таны бодит байгууллагын ID болон өөрийн түлхүүрийг автоматаар бөглөж, шууд ажиллаж буй API рүү хүсэлт илгээх тул та бодит хариуг харах боломжтой болно. Энэ төгсгөлийн цэгийг API консол дээр нээх

Дэлгэрэнгүй

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

Параметрүүд

НэрТөрөлЗаавал шаардлагатайЭнэ юу вэ
siteId (path)UuidТиймSite ID (UUIDv7).

Хүсэлтийн бие

НэрТөрөлЗаавал шаардлагатайЭнэ юу вэ
frequencystring<always, hourly, daily, weekly, monthly, never, yearly>ҮгүйThe `changefreq` written into the generated XML. A guideline to search engines, not a guarantee.
uploadbooleanҮгүйOverwrite `sitemap.xml` in the webspace when the crawl finishes.

Хариу үйлдэл

НэрТөрөлЗаавал шаардлагатайЭнэ юу вэ
ever_runbooleanТиймHas a crawl ever been run for this site?
runningbooleanТиймIs 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.
statestringТиймThe vendor's own job state, verbatim. Empty when none has run.
created_atstringТиймWhen the most recent crawl started. Empty when none has run.
outputstringТиймThe crawler's own output, if it produced any.
uploadbooleanТиймWhether the crawl writes `sitemap.xml` into the webspace.
frequenciesstring[]ТиймThe change frequencies this site's crawler accepts.

Энэ төгсгөл цэгээс буцааж болох алдаанууд

401 · 403 · 404 · 422 · 429 · 503