Käynnistä build
POST /v1/buildsJSON-runko
{
"dataset_id": "finnish-vehicle-market-listings",
"definition_version": "0.2.0",
"source_snapshot_ids": ["snapshot-20260813"]
}202 JSON
{
"id": "build_preview_1",
"status": "queued",
"dataset_id": "finnish-vehicle-market-listings",
"definition_version": "0.2.0",
"created_at": "2026-08-15T09:00:00.000Z"
}Buildin elinkaari
| Tila | Merkitys | Päätöstila |
|---|---|---|
| queued | Hyväksytty ja odottaa kapasiteettia | Ei |
| running | Builder käsittelee lähdesnapshotteja | Ei |
| completed | Build valmistui; tarkista syntynyt release-työnkulku | Kyllä |
| failed | Build pysähtyi virheeseen | Kyllä |
| cancelled | Peruutus hyväksyttiin | Kyllä |
Pollaa rajatulla välillä
cURL
curl "https://api.datasets.nordicdevhouse.com/v1/builds/build_preview_1" \
-H "Authorization: Bearer $DATASET_API_KEY" \
-H "X-API-Version: 1"Pollaa GET /builds/{build_id}, kunnes tila on päätöstila. Käytä rajattua, satunnaisvaihtelulla täydennettyä väliä ja lopeta oman operatiivisen määräajan jälkeen jatkuvan pollauksen sijaan.
Peruutus on tilasiirtymä
DELETE /v1/builds/{build_id}Onnistunut peruutus palauttaa build-objektin. Lue palautettu tila sen sijaan, että olettaisit asiakasyhteyden sulkemisen peruuttaneen palvelinpuolen työn.