Qendra e Zhvilluesve

Udhëzuesi i API-t të të Dhënave të Tregut Encar

Integroni të dhënat e shpejta dhe me saktësi të lartë të makinave të përdorura të Koresë së Jugut direkt në faqen tuaj të internetit të personalizuar, CRM, sistemin e shitësit ose menaxherin e stokut. Çdo pikë fundore përkthen automatikisht listat e kontrollit të opsioneve dhe regjistrat e historikut të aksidenteve në anglisht të strukturuar.

Fillimi i Shpejtë i Integrimit të Klientit

1. Titulli i Autentifikimit

Për të bërë kërkesa te pikat fundore të API-t tonë, duhet të përfshini çelësin tuaj privat të API-t të klientit në kokat e kërkesës suaj duke përdorur emrin e çelësit. çelësi-x-api.

headers: {
  "x-api-key": "YOUR_RIN_API_KEY_HERE"
}

2. Origjinat e Lejuara dhe Bllokimi i CORS

Për siguri, çelësat API bllokohen duke përdorur **Kyçjen e Domenit (CORS)**. Sfondi bllokon thirrjet që burojnë nga faqet e internetit të paautorizuara.

Gabim i Marrjes së Rrjetit / Probleme me CORS?

Nëse aplikacioni juaj i frontend-it merr një Gabim Rrjeti gjatë përpjekjes për të marrë burimin, sigurohuni që:

Domeni i faqes suaj të internetit (p.sh. https://yourdomain.com) është në listën e bardhë në cilësimet e Çelësit API.
Kur testoni në nivel lokal, shtoni http://localhost:3000 ose http://localhost:3001 te origjinat tuaja të lejuara.
Ose drejtoni kërkesat përmes backend-it tuaj (server-me-server) për të shmangur ekspozimin e çelësit tuaj API dhe për të anashkaluar kufizimet e CORS të shfletuesit.

Strehuesi bazë i API-t

https://api.rinevoapi.autos

Strategjia e Integrimit

Server-me-Server (I rekomanduar) : Bëni kërkesa nga backend-i juaj Node.js, Python ose PHP. Kjo e fsheh çelësin tuaj privat të API-t nga pamja publike dhe shmang plotësisht kontrollet CORS.

Limitet e Tarifave

Përgjigjet kthejnë tituj që kufizojnë shpejtësinë standarde për të kontrolluar alokimin: X-RateLimit-Limit dhe X-RateLimit-Mbetje.

Pikat fundore të API-t

Parametrat e pyetjes

:carId

Identifikuesi numerik i automjetit Encar

E detyrueshme

apiKey

Parametri alternativ i vargut të autorizimit

Opsionale

Kërkesë për fragment

curl -X GET "https://api.rinevoapi.autos/api/scraper/cars?brand=Hyundai&model=Tucson&priceMax=35000000" \ -H "x-api-key: YOUR_API_KEY"

Ngarkesa e Përgjigjes (JSON)

200 Në rregull

{
  "success": true,
  "data": {
    "cars": [
      {
        "id": "42047351",
        "encar_id": "42047351",
        "title": "Hyundai Tucson 1.6 Premium",
        "brand": "Hyundai",
        "model": "Tucson",
        "year": 2023,
        "price": 28500000,
        "currency": "KRW",
        "mileage": 18240,
        "fuelType": "Gasoline",
        "transmission": "Automatic",
        "color": "White",
        "type": "SUV",
        "image": "https://ci.encar.com/carpicture/...",
        "images": [
          "https://ci.encar.com/carpicture/1.jpg"
        ],
        "prices": {
          "EUR": 19655,
          "USD": 21111,
          "KRW": 28500000
        },
        "vin": "204저1294",
        "scraped_at": "2026-06-01T14:35:44.800Z",
        "updated_at": "2026-06-01T14:35:44.800Z"
      }
    ],
    "pagination": {
      "total": 126641,
      "page": 1,
      "limit": 10,
      "hasNext": true,
      "hasPrev": false
    }
  }
}

Keni nevojë për integrime të skemave të personalizuara?

Ne ofrojmë zgjidhje të personalizuara API, njoftime të personalizuara për webhook, eksportime masive të bazës së të dhënave dhe kanale të dedikuara për rrugëzim me performancë të lartë për ndërmarrjet dhe shitësit me vëllim të lartë.

Kontaktoni Shitjet e Ndërmarrjes