Ennen kuin aloitat
Tarvitset Scraping Operations -tilin ja API-avaimen. Jos sinulla ei vielä ole tiliä, luo se ja generoi API-avain työtilassa.
1. Luo API-avain
Luo API-avain työtilan API Keys -sivulta. Kopioi avain talteen — näet sen vain kerran.
2. Tee ensimmäinen pyyntö
Lähetä URL-osoite Scraping APIin. Tämä pyyntö odottaa validoitua JSON-tulosta ja sopii ensimmäiseen integraatiotestiin.
curl -X POST https://api.nordicdevhouse.com/v1/scrape \
-H "Authorization: Bearer ndh_live_••••••••" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/products",
"formats": ["json"]
}'3. Tarkista vastaus
Valmis vastaus sisältää vakaan työtunnisteen, normalisoidun datan, tietuemäärän ja pyynnön metatiedot. Tallenna työtunniste, jotta tuki- ja valvontatapahtumat voidaan yhdistää.
{
"id": "job_01J4N7BK8R5P",
"status": "completed",
"records": 24,
"data": [
{ "name": "Example product", "price": 129.90 }
]
}4. Vie tuotantoon
Lisää aikakatkaisut, eksponentiaalinen odotus, idempotenssi ja webhook-allekirjoitusten tarkistus ennen liikenteen kasvattamista. Seuraa 429- ja 5xx-vastauksia erillään pysyvistä validointivirheistä.