hosting
POST /v1/bulk-jobs/{bulkJobId}/retry-failed
Run a bulk job's failures again.
Hitelesítés
Küldjön egy API-kulcsot bearer tokenként. A kulcsnak rendelkeznie kell a(z) sites.view jogosultsággal; az ezzel nem rendelkező kulcsok esetén a rendszer 403-as hibát ad vissza 404 helyett.
Ez a végpont nem fogad el szervezeti azonosítót. Az Ön kulcsa már azonosítja azt a szervezetet, amelyhez tartozik, és a válasz is erre vonatkozik.
Próbálja ki
Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.
curl -X POST https://api.zinndigital.com/v1/bulk-jobs/{bulkJobId}/retry-failed \
-H "Authorization: Bearer zdk_live_…"Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban
Részletek
Puts the failed and skipped items back to pending and restarts the job's workflow. ⭐ unsupported items are not reopened, and that is deliberate: a platform with no shell will not grow one because somebody pressed a button, so a retry that provably does nothing is how a control stops being believed. A job that is still running is a 409 — the restart reuses the job's own workflow id, so this cannot start a second pass over the same rows. A job with nothing left to retry is a 422. Requires sites.view plus the operation's own key.
Paraméterek
| Név | Típus | Kötelező | Mi ez |
|---|---|---|---|
bulkJobId (path) | Uuid | Igen | Bulk job ID (UUIDv7). |
Válasz
| Név | Típus | Kötelező | Mi ez |
|---|---|---|---|
id | Uuid | Igen | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
org_id | Uuid | Igen | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
operation | BulkOperation | Igen | What a bulk job does to each of its sites. ⛔ One job model with an operation discriminator, not eight job models. A selection, a frozen work-list, a durable pass and a per-site… |
params | BulkJobParams | Igen | The operation's arguments. Which keys are read depends on operation: plugin_install takes slugs + activate; plugin_activate, plugin_deactivate and plugin_remove take… |
selector | BulkSelector | Igen | Which sites a job targets. ⛔ There is no all. A job belongs to exactly one organization and all would span every tenant on the platform; the fleet-wide act is a staff… |
selector_value | string | Igen | — |
status | BulkJobStatus | Igen | ⛔ partial is a real outcome, not a rounding of the other two. A job where 4 of 900 sites failed is neither a success nor a failure, and reporting it as either is how a bulk… |
requested_by | string | Igen | Who asked for it. |
note | string | Igen | — |
created_at | string | Igen | — |
updated_at | string | Igen | — |
settled_at | object | Igen | When the job finished; null while it is still running. |
counts | BulkJobCounts | Igen | — |
progress | BulkJobProgress | Igen | How far along a job is, how fast it is going and how much longer it has. ⛔⛔ Every estimate here is nullable, and a null must never be rendered as 0. rate_per_minute: 0… |
Hibák, amelyeket ez a végpont visszaadhattatlan
401 · 403 · 404 · 409 · 422 · 429