VOOR AANGESLOTEN WEBSITES
Jouw website.
De cadeaus van KopGek.
Haal producten op, stuur gepersonaliseerde aanvragen in en volg de levering vanuit je eigen systeem.
Aansluiten
Vraag een eigen partnersleutel aan bij info@kopgek.nl. Gebruik deze uitsluitend op je server, nooit in een browser, appbundel of openbare code. Iedere partner kan alleen zijn eigen orders opvragen. De limiet is 60 aanvragen per minuut per sleutel.
Basisadres:
| Methode | Route | Doel |
|---|---|---|
| GET | /api/v1/products | Producten en huidige richtprijzen, openbaar |
| GET | /api/v1/shipping/methods | Leveringsmogelijkheden, openbaar |
| POST | /api/v1/shipping/quote | Verzendkosten of melding “offerte nodig” |
| POST | /api/v1/orders | Nieuwe aanvraag |
| GET | /api/v1/orders/{id} | Eigen aanvraag en track & trace |
| GET | /api/v1/status | Aansluitstatus, openbaar |
Voorbeeld: een mok aanvragen
Gebruik dezelfde Idempotency-Key bij een retry. Dezelfde aanvraag levert dezelfde order op. Andere inhoud met dezelfde sleutel geeft HTTP 409. Prijzen, betaalstatus en leveranciersproductcodes worden niet door de partner bepaald.
Verzendkosten
{
"method": "delivery",
"country": "NL",
"items": [{"productId": "mok", "quantity": 1}]
}Levering: pickup, delivery of digital. Bij delivery is een adres in NL of BE verplicht. Een bedrag null betekent dat een offerte nodig is; het betekent nooit gratis verzending. Een test_quote is geen definitief live-tarief. Print API-boeken worden rechtstreeks verstuurd.
Boeken en drukbestanden
Gebruik hardcover-vierkant of hardcover-a4 en pageCount. Deze zijn aanvraagproducten; bestelbaarheid, pagina-aantal en afmetingen moeten door de leverancier worden bevestigd. Nieuwe producten krijgen pas een prijs na geverifieerde inkoop × 2 op dezelfde btw-basis. De bestaande prijzen blijven behouden.
De gecontroleerde omslag en het binnenwerk worden als aparte PDF-bestanden aangeleverd bij KopGek. Alleen beheer kan een gecontroleerde proef, betaal- of akkoordreferentie en goedgekeurde bestandslinks vrijgeven voor productie. Deze API genereert nog geen nieuw AI-beeld of drukklaar boekbestand.
Statussen en fouten
requested → submitted → processing → shipped. Een onzekere leveranciersaanvraag krijgt needs_review; die wordt niet automatisch opnieuw besteld. cancelled betekent geannuleerd bij de leverancier. submitting betekent dat de aanvraag wordt verstuurd. Track & trace kan later beschikbaar komen.
Fouten hebben de vorm {"error":{"code":"…","message":"…"}}. HTTP 400: invoer; 401: sleutel; 404: order niet gevonden; 409: conflict; 429: limiet; 502/503: tijdelijk niet beschikbaar. Bewaar de Idempotency-Key bij een retry.
OpenAPI-specificatie downloaden
Print API-documentatie
Orders en PDF-bestanden · Verzendkosten · Status en webhooks