API-referentie

Dit token wordt vervangen zodra je deze pagina herlaadt, en er kan niet mee besteld worden. Bouw er dus niets mee: zet dropshipping aan op je eigen account voor een token dat blijft.

curl -H "Authorization: Bearer JOUW_TOKEN" https://api.l33d.be/api/dropship/status

• Bedragen staan in centen, inclusief btw.
• Met een testtoken gaat alles naar de testomgeving: niets wordt echt besteld of betaald. GET /status zegt in environment waar je zit.
• Fouten komen terug als JSON met error: 401 ongeldig token, 404 niet gevonden of niet van jou, 422 foute invoer, 429 te veel aanvragen, 503 onderhoud (probeer opnieuw na Retry-After).

{"reason":"Klant annuleerde"}

{"label":"Bakkerij","first_name":"Jan","last_name":"Peeters","street":"Kerkstraat","house_number":"12","postal_code":"3500","city":"Hasselt","country":"BE"}

{"price_cents":1299}

{"markup_percent":40}

Zelf geen editor bouwen? Dat is de aanbevolen weg. Zie Logo positioneren

De prijs in het antwoord is wat jij ons betaalt: staffel, jouw korting, toeslagen, btw en verzending naar het adres van de eindklant. Wat jij je eigen klant aanrekent staat daar los van. Je hoeft zelf niets te herrekenen.

Standaard gaat het van je credits en start de productie meteen. Is je saldo te laag, of vraag je om een betaallink of een factuur, dan wacht de bestelling op betaling.

curl -X POST https://api.l33d.be/api/dropship/orders \
  -H "Authorization: Bearer JOUW_TOKEN" -H "Content-Type: application/json" \
  -d '{
    "reference": "WC-1042",
    "payment": "credits",
    "address": { "first_name": "Jan", "last_name": "Peeters",
      "street": "Kerkstraat", "house_number": "12",
      "postal_code": "3500", "city": "Hasselt", "country": "BE" },
    "items": [
      { "quantity": 2, "position_session_token": "..." }
    ]
  }'

{
  "items": [
    { "product_id": 23, "quantity": 2, "text": "Voor opa" },
    { "product_id": 23, "quantity": 1,
      "logo_url": "https://jouwsite.be/logo.png",
      "logo_position": { "cx": 0.5, "cy": 0.5, "w": 0.4, "angle": 90 } }
  ]
}

• payment: credits (standaard), link (het antwoord bevat pay_url) of invoice (als factuur voor jou aan staat).
• Dezelfde reference binnen de dag geeft de bestaande bestelling terug met already_known: true. Opnieuw proberen na een time-out is dus veilig.
• Een logo_url halen wij zelf op, of stuur logo_base64. PNG, JPG of WebP, maximaal 5 MB. Zonder logo_position centreren we het in de gravurezone.
• Heeft een product kleuren (colors in GET products), geef dan color_id mee. Zonder color_id nemen we de standaardkleur.
• Het antwoord (201) bevat order_number, total_cents, paid, insufficient_credits, credit_balance_cents, pay_url en track_url. In plaats van een volledig adres mag je ook address_id uit je adresboek meesturen.

GET  https://api.l33d.be/api/dropship/orders/{number}
POST https://api.l33d.be/api/dropship/orders/{number}/cancel
     { "reason": "Klant annuleerde" }

< { "ok": true, "status": "cancelled", "order": { ... } }

# 1. code aanvragen
POST https://api.l33d.be/api/dropship/credits/topup
{ "amount_cents": 5000 }
< { "ok": true, "code": "…", "url": "https://l33d.be/dropshipping/opwaarderen/…", "status": "open", "test": false }

# 2. url openen in de browser: daar wordt betaald

# 3. de stand opvragen tot betaald of mislukt
GET https://api.l33d.be/api/dropship/credits/topup/{code}
< { "ok": true, "status": "betaald", "balance_cents": 12500 }

status: open, betalen, betaald, mislukt of verlopen. Een code is twee uur geldig. In de testomgeving wordt de betaling op die pagina nagebootst.

Controleer de afzender met de header X-L33D-Signature: een sha256-HMAC over de rauwe body, met je API-token als sleutel.

$body = file_get_contents('php://input');
$sig  = $_SERVER['HTTP_X_L33D_SIGNATURE'] ?? '';
if (!hash_equals(hash_hmac('sha256', $body, 'JOUW_TOKEN'), $sig)) {
    http_response_code(401); exit;
}
$event = json_decode($body, true);
// X-L33D-Event / event: order.status_changed | order.tracking_added | test
// data: order_number, status, total_cents, tracking_code, tracking_url, end_customer