Try it yourself
Opens a real session on a real product: the same screen your end customer gets. Nothing is ordered.
The full editor, white label
You can calculate coordinates yourself, but then you have no multiple objects and no second side. So leave the designing to us: you create a session and get a link to the same editor as on our own site. It carries no reference to us at all.
Send that link to whoever makes the design, yourself or your end customer. Once confirmed you fetch the result, or we send the browser back to your own address. When ordering you pass the token: we then calculate the price and attach the exact design to the order.
The usual flow
- 1 Your customer looks at a product on your site.
- 2 They click personalise. Your site creates a session and opens the link.
- 3 They add text or a logo and confirm. That happens on our side, white label.
- 4 They check out on your site. We play no part in that.
- 5 Once paid, your system places the order with the token.
In code
curl -X POST https://api.l33d.be/api/dropship/position-sessions \
-H "Authorization: Bearer JOUW_TOKEN" -H "Content-Type: application/json" \
-d '{"product_id": 1, "redirect_url": "https://jouwsite.be/klaar"}'
# -> { "token": "...", "position_url": "https://l33d.be/positioneren/...", "expires_at": "..." }
curl https://api.l33d.be/api/dropship/position-sessions/{token} -H "Authorization: Bearer JOUW_TOKEN"
# -> { "status": "done", "layout": {...}, "preview_url": "..." }
curl -X POST https://api.l33d.be/api/dropship/orders \
-H "Authorization: Bearer JOUW_TOKEN" -H "Content-Type: application/json" \
-d '{"address": {...}, "items": [{"quantity": 1, "position_session_token": "..."}]}'
A link is valid for 24 hours and is confirmed once.
In a frame on your own shop
If you send your customer to the link, our address sits in their address bar. Put that link in a frame on your own page and they only see the design screen, and stay with you.
For that we need to know which domain the frame will sit on: pass embed_url when creating the session. If you already use a redirect_url we take the domain from that, and you need do nothing extra. The page in that frame needs no cookie from us — the token in the link is the key.
POST https://api.l33d.be/api/dropship/position-sessions
{
"product_id": 1,
"embed_url": "https://jouwwinkel.be"
}
<iframe src="https://l33d.be/positioneren/..."
style="width:100%;height:90vh;border:0"></iframe>
Https only. A frame over an unsecured connection would leave the engraving and your customer's name readable in transit. And it applies per session, for your domain alone.
Or coordinates of your own?
That works too. An order line still accepts a text, a logo and a position. Handy for one logo in a fixed spot. For everything else the hosted editor is the shortest route. See API reference