Ennen kuin aloitat
Käytä palvelinpuolen ympäristöä ja Dataset API -bearer-avainta. Esimerkit käyttävät tuotannon v1-perusosoitetta; käytä sandbox-osoitetta testiliikenteelle.
1. Listaa katalogi
cURL
curl "https://api.datasets.nordicdevhouse.com/v1/datasets" \
-H "Authorization: Bearer $DATASET_API_KEY" \
-H "Accept: application/json" \
-H "X-API-Version: 1"Valitse dataset tunnisteella ja tarkista fields-, identity_fields- ja latest_release-kentät ennen tuontiprosessin rakentamista.
2. Kiinnitä release
cURL
curl "https://api.datasets.nordicdevhouse.com/v1/datasets/finnish-vehicle-market-listings/releases/dsv-preview-finnish-vehicle-market-listings" \
-H "Authorization: Bearer $DATASET_API_KEY" \
-H "X-API-Version: 1"Vaadi immutable=true. Päätä erikseen, hyväksyykö työnkulku quality_status=partial-releaset vai vain complete-releaset.
3. Kysy rivejä
cURL
curl -X POST "https://api.datasets.nordicdevhouse.com/v1/datasets/finnish-vehicle-market-listings/query" \
-H "Authorization: Bearer $DATASET_API_KEY" \
-H "Content-Type: application/json" \
-H "X-API-Version: 1" \
-d '{
"release_id": "dsv-preview-finnish-vehicle-market-listings",
"filters": { "make": "Toyota" },
"fields": ["make", "model", "year", "price_eur"],
"limit": 50
}'200 JSON
{
"data": [
{ "make": "Toyota", "model": "Corolla", "year": 2022, "price_eur": 23900 }
],
"meta": {
"count": 1,
"dataset_id": "finnish-vehicle-market-listings",
"release_id": "dsv-preview-finnish-vehicle-market-listings",
"dataset_version": "dsv-preview-20260813",
"quality_status": "complete",
"partial": false
}
}4. Valmistaudu tuotantoon
- 1Tallenna valittu release-tunniste tuotujen rivien kanssa
- 2Aseta yhteys- ja kokonaisaikakatkaisut
- 3Toista vain turvalliset lukupyynnöt ja selvästi tilapäiset virheet
- 4Kirjaa virhevastausten request_id
- 5Seuraa partial-releaseja erillään complete-releaseista