Jouw voorraad.
Direct verbonden.

Van sleutel naar eerste voertuig.

1. Log in met je bedrijfsaccount. Maak hieronder een sleutel voor jouw koppeling. Begin met alleen lezen; voeg schrijven en publiceren alleen toe als je toepassing die rechten nodig heeft.
2. Bewaar de sleutel op je server. Gebruik een secret manager of een afgeschermde omgevingsvariabele. Zet de sleutel nooit in browsercode, een app, URL, log, e-mail of een openbaar repository.
3. Lees eerst je voorraad uit. Gebruik HTTPS en stuur de sleutel in de Authorization-header. Upload eerst een eigen foto, maak je eerste voertuig als concept aan en controleer de gegevens in je account.

curl --fail-with-body 'https://autokern.nl/api/v1/stock.php?offset=0&limit=50' \
  -H "Authorization: Bearer $AUTOKERN_API_KEY" \
  -H 'Accept: application/json'

De sleutel bepaalt het bedrijf. Je stuurt geen bedrijfs-ID mee en krijgt geen gegevens van andere bedrijven. Dit is een server-naar-server-API; rechtstreekse databaseverbindingen, tabellen, wachtwoorden en interne accountgegevens worden niet beschikbaar gesteld.

Lezen, opslaan en foto’s toevoegen.

Basisadres: https://autokern.nl/api/v1/stock.php. Alle antwoorden zijn JSON. POST vereist Content-Type: application/json. Eén aanvraag verwerkt één voertuig of één foto.

Upload vooraf een foto met action: "photo" (zie hieronder). Vervang in het voorbeeld de fotoplaatsaanduiding door de volledige ontvangen image-waarde.

curl --fail-with-body 'https://autokern.nl/api/v1/stock.php' \
  -H "Authorization: Bearer $AUTOKERN_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "action": "upsert",
    "externalId": "dms-1042",
    "state": "DRAFT",
    "channels": [],
    "data": {
      "brand": "Volvo", "model": "XC60",
      "year": 2021, "km": 64000, "price": 34950,
      "priceOnRequest": false,
      "fuel": "Benzine", "gear": "Automaat",
      "description": "Voertuigomschrijving van het autobedrijf.",
      "images": ["VUL_HIER_DE_ONTVANGEN_IMAGE_REFERENTIE_IN"],
      "features": ["Cruisecontrol"]
    }
  }'

{
  "ok": true,
  "vehicle": {
    "externalId": "dms-1042",
    "id": "0123456789abcdef0123456789abcdef",
    "version": 1,
    "state": "DRAFT",
    "channels": [],
    "data": { "brand": "Volvo", "model": "XC60" }
  },
  "unchanged": false
}

Herhalen zonder dubbele voertuigen

Houd externalId blijvend gelijk voor dezelfde auto. De combinatie van jouw bedrijf en dit nummer is uniek. Een identieke herhaling retourneert unchanged: true. Dit is geen gedeeltelijke PATCH: stuur bij iedere wijziging het volledige data-object, de gewenste status en alle kanalen. Weggelaten optionele velden worden niet behouden.

Lees vóór aanpassen de huidige version, stuur die mee en bewaar de nieuwe versie uit het antwoord. Bij 409 lees je opnieuw, vergelijk je de gegevens en beslis je welke wijziging moet blijven. Laat version bij een nieuw voertuig weg. Tekstvelden die je weglaat worden leeg, getalvelden null, priceOnRequest false en features leeg. Foto’s zijn altijd vereist.

Foto’s: uploaden, daarna koppelen

Verklein iedere foto naar een JPEG van maximaal 800 × 800 pixels en 512 KiB. Upload eerst met onderstaande JSON. Gebruik de geretourneerde image-waarde ongewijzigd in data.images van je voertuig. Minimaal 1 en maximaal 40 eigen foto’s per voertuig, ook voor een concept. Gebruik alleen eigen foto’s waarvoor je publicatierechten hebt.

{ "action": "photo", "image": "data:image/jpeg;base64,/9j/…" }

{ "ok": true, "image": "/api/account.php?action=photo&id=…" }

De voorbeeldfoto is ingekort en niet uitvoerbaar. Externe foto-URL’s, HTML, SVG en fotoverwijzingen van een ander account worden niet aangenomen. Er worden geen externe URL’s opgehaald. Bewaar de fotoverwijzing voor hergebruik; upload dezelfde foto niet bij iedere synchronisatie opnieuw.

Dit mag je koppeling versturen.

De API wisselt een afgebakend JSON-gegevensmodel uit. Onbekende velden worden geweigerd. Gebruik JSON-getallen zonder valuta- of duizendtalscheiding; een prijs van € 34.950 schrijf je als 34950. Tekst is platte tekst. Tekstlimieten gelden in UTF-8-bytes: een letter zoals é gebruikt 2 bytes.

Het antwoord voegt een interne id en version toe. Behandel de ID als ondoorzichtige waarde; gebruik jouw externalId voor synchronisatie. De API geeft geen gebruikersprofielen, leads, wachtwoorden, handelsprijzen, VIN of interne importbronnen terug.

Opslaan is nog geen publiceren.

Een nieuw voertuig begint in je koppeling met state: "DRAFT" en channels: []. Zo kun je eerst rustig controleren. Een kanaal vraagt expliciete publicatierechten en blijft afhankelijk van de bestaande bedrijfsverificatie, pakketafspraken en inhoudscontrole.

Om te publiceren stuur je de volledige gegevens, de huidige version, state: "AVAILABLE" en de gewenste channels. Kanalen zijn alleen toegestaan voor AVAILABLE en RESERVED. Bij alle andere statussen stuur je channels: []. Ook wijzigen of intrekken van eerder gepubliceerd aanbod vereist inventory:publish. Voor publicatie zijn merk, model, bouwjaar, kilometerstand, brandstof, transmissie, carrosserie, minimaal één eigen foto en een geldige prijs of prijs op aanvraag nodig. Een succesvolle conceptopslag bewijst niet dat een advertentie openbaar staat; controleer de publicatiestatus in je bedrijfsaccount.

Een helder budget voor je koppeling.

• 600 aanvragen per rollend uur en 60 per minuut, gedeeld door alle sleutels van één bedrijf. Nieuwe sleutels maken dit budget niet opnieuw vrij.
• Maximaal 2 actieve sleutels; geldigheid 1–90 dagen. Draai een sleutel door eerst een vervanger aan te maken, je systeem om te zetten en daarna de oude in te trekken.
• Maximaal 2.000 voertuigen per account; pakket- en publicatiegrenzen blijven gelden.
• Maximaal 64 KiB JSON per voertuigaanvraag; 768 KiB voor een fotoaanvraag. Foto zelf maximaal 512 KiB en 800 × 800 pixels.
• Maximaal 4.096 fotobestanden en 256 MiB foto-opslag per account. Hergebruik bestaande fotoverwijzingen.

Plan kleine gespreide synchronisaties. Stuur alleen gewijzigde voertuigen, haal voorraad gepagineerd op en wacht bij 429 minstens het aantal seconden in de Retry-After-header. Gebruik daarna oplopende wachttijden met willekeurige spreiding. Probeer een inhoudsfout niet eindeloos opnieuw.

{ "ok": false, "error": "…", "message": "…" }

Antwoorden bevatten requestId; de header X-Request-Id helpt support de aanvraag terug te vinden. Geldige geauthenticeerde aanvragen geven X-RateLimit-Limit en X-RateLimit-Remaining; ook geweigerde inhoud kan budget verbruiken. Er gelden aanvullende misbruikgrenzen per bron-IP. Gebruik de HTTP-status voor je herstelstrategie en toon het serverbericht aan de beheerder. Log status, tijdstip en je eigen voertuigreferentie; verwijder Authorization en andere geheimen uit logbestanden.