Kysy yhtä datasettiä
POST /v1/datasets/{dataset_id}/querycURL
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
}'Lähetä release_id toistettavuutta varten
release_id on skeemassa valinnainen, mutta tuotantotuonnin kannattaa lähettää se. Sen puuttuminen siirtää release-valinnan palvelimen politiikalle ja vaikeuttaa toistettujen pyyntöjen vertailua.
Suodattimet ovat tarkkoja osumia
v1-esikatseluadapteri vertaa suodatinarvoja tarkasti merkkijononormalisoinnin jälkeen. Tuetut arvot ovat merkkijono, numero, totuusarvo tai merkkijonotaulukko. Älä oleta alueita, contains-hakua, järjestystä, liitoksia tai tekstihakua ennen kuin myöhempi sopimusversio lisää ne.
Valitse vain tarvitsemasi kentät
fields hyväksyy enintään 100 nimeä. Projektio pienentää vastausta ja selkeyttää jatkokäsittelyn omistajuutta. Varmenna kenttänimet dataset-määrittelystä sen sijaan, että luottaisit hiljaisesti väärin kirjoitettuihin nimiin.
Tulos on rajattu, ei sivutettu
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
}
}Vie vastausmetadata eteenpäin
| Kenttä | Miksi se on tärkeä |
|---|---|
| count | Tässä vastauksessa palautettujen rivien määrä |
| dataset_id | Vahvistaa valitun katalogin |
| release_id | Tekee tuloksesta toistettavan |
| dataset_version | Yksilöi dataversion |
| quality_status | Kuljettaa releasen laatupäätöksen |
| partial | Koneluettava osittaisen datan signaali |