Siirry dokumentaation sisältöön
Dataset APIDocs

Kokonaisesimerkit

Toteuta releaseen kiinnitetty työnkulku curlilla, Pythonilla tai JavaScriptillä.

Tässä oppaassa
  1. 1Löydä
  2. 2Kiinnitä
  3. 3Kysy
  4. 4Vie metadata eteenpäin
Tässä oppaassa
  1. 1Löydä
  2. 2Kiinnitä
  3. 3Kysy
  4. 4Vie metadata eteenpäin

Tuotantotyönkulku

  1. 1
    Listaa saatavilla olevat datasetit
  2. 2
    Valitse dataset ja tarkista sen kenttäsopimus
  3. 3
    Valitse complete ja immutable release
  4. 4
    Kysy rajattu otos tai lataa koko tiedosto
  5. 5
    Tallenna release- ja laatumetadata tuonnin kanssa

Natiivien HTTP-asiakkaiden esimerkit

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
  }'
Python
import os
import requests

base_url = "https://api.datasets.nordicdevhouse.com/v1"
headers = {
    "Authorization": f"Bearer {os.environ['DATASET_API_KEY']}",
    "X-API-Version": "1",
}

catalog = requests.get(f"{base_url}/datasets", headers=headers, timeout=20)
catalog.raise_for_status()
dataset = catalog.json()["data"][0]
release_id = dataset["latest_release"]["id"]

response = requests.post(
    f"{base_url}/datasets/{dataset['id']}/query",
    headers={**headers, "Content-Type": "application/json"},
    json={"release_id": release_id, "limit": 100},
    timeout=30,
)
response.raise_for_status()
print(response.json())
JavaScript
const baseUrl = "https://api.datasets.nordicdevhouse.com/v1";
const headers = {
  Authorization: `Bearer ${process.env.DATASET_API_KEY}`,
  "X-API-Version": "1",
};

const catalogResponse = await fetch(`https://api.datasets.nordicdevhouse.com/v1/datasets`, { headers });
if (!catalogResponse.ok) throw new Error(`Catalog failed: ${catalogResponse.status}`);
const [dataset] = (await catalogResponse.json()).data;

const queryResponse = await fetch(`${baseUrl}/datasets/${dataset.id}/query`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ release_id: dataset.latest_release.id, limit: 100 }),
});
if (!queryResponse.ok) throw new Error(`Query failed: ${queryResponse.status}`);
console.log(await queryResponse.json());

Aja esikatselutyönkulku

Löydä ja kysy releasea
  1. 1
    listDatasets
  2. 2
    getDatasetRelease
  3. 3
    queryDataset

Validoi jokainen vastausraja

Oliko tästä sivusta apua?