Kopflose API
REST API für modernen elektronischen Handel
Ergänzen Sie die Standard-API von Shoporama mit grundlegenden E-Commerce-Funktionen
Basis-URL
https://din-shop.dk/api
💡 Sitzungsmanagement
Die API verwendet Cookies, um Warenkorb und Sitzung zu verwalten. Für herkunftsübergreifende Anfragen, verwenden Sie credentials: 'include'.
Unsere Produkte
Produkte auflisten
GET /api/products?limit=20&offset=0&category_id=5
{
"success": true,
"data": {
"products": [
{
"id": 123,
"name": "Produkt navn",
"price": 299.95,
"url": "/produkt-navn",
"images": [...]
}
],
"pagination": {
"total": 156,
"limit": 20,
"offset": 0
}
}
}Einzelnes Produkt
GET /api/products/123
{
"success": true,
"data": {
"id": 123,
"name": "Produkt navn",
"description": "Beskrivelse...",
"price": 299.95,
"in_stock": true,
"images": [
{
"id": 456,
"formats": {
"original": "https://...",
"thumbnail": "https://..."
}
}
]
}
}Korb
In den Warenkorb legen
POST /api/basket
Körper der Anfrage:
{
"product_id": 123,
"amount": 2
}Menge aktualisieren
PUT /api/basket/123
Körper der Anfrage:
{
"amount": 5
}Aus dem Korb nehmen
DELETE /api/basket/123
Korb ansehen
GET /api/basket
{
"success": true,
"data": {
"items": [
{
"product_id": 123,
"name": "Produkt navn",
"price": 299.95,
"amount": 2,
"total": 599.90
}
],
"subtotal": 599.90,
"shipping": 39.00,
"total": 638.90
}
}Ansicht bestellen
Details zur Bestellung anzeigen
GET /api/order?order_id=621&chk=aef1dab1fe24a18fdcf675c09a34bf34
Liefert vollständige Bestellinformationen, einschließlich Produkte, Adressen, Preise und Versand.
chk-Parameter ist ein MD5-Hash der Kunden-E-Mail zur Sicherheit.
{
"success": true,
"data": {
"order": {
"order_id": "1738",
"status": "new",
"total": "1067.59",
"currency": "DKK",
"customer": {
"name": "Morten Nielsen",
"email": "kunde@example.com"
},
"products": [
{
"name": "Kim og Tysklæreren",
"price": "129.95",
"quantity": "9",
"image": {
"url": "https://shop.dk/cache/fit-300x300x90.png"
}
}
],
"totals": {
"subtotal": "1052.59",
"shipping": "15.00",
"total": "1067.59"
}
}
}
}💡 Sicherheit
Die Bestell-API benötigt den Parameter chk, der den MD5-Hash der E-Mail-Adresse des Kunden darstellt. Dadurch wird sichergestellt, dass nur der Kunde seine eigene Bestellung sehen kann.
Einstellungen und Präferenzen
Handelsbedingungen und andere Einstellungen abrufen
GET /api/settings
Gibt wichtige Webshop-Einstellungen zurück, vor allem die Allgemeinen Geschäftsbedingungen.
{
"success": true,
"data": {
"terms": "<p>Lorem ipsum dolor sit amet...</p>",
"has_terms": true
}
}💡 Anwendung
Wird in der Regel verwendet, um die Allgemeinen Geschäftsbedingungen in der Kaufabwicklung anzuzeigen, die der Kunde vor Abschluss des Kaufs akzeptieren muss.
Checkout-Fluss
Schritt 1: Kundeninformationen
POST /api/checkout
{
"step": "address",
"email": "kunde@example.com",
"name": "Anders Andersen",
"address": "Vestergade 10",
"zipcode": "8000",
"city": "Aarhus",
"country": "DK",
"phone": "12345678"
}Schritt 2: Versandart
POST /api/checkout
{
"step": "shipping",
"shipping_id": 1
}Im Paketshop:
{
"step": "shipping",
"shipping_id": 2,
"shop": "5004",
"shop_name": "Pakkeshop Føtex",
"shop_street": "Vesterbro 39",
"shop_zip": "5000",
"shop_city": "Odense C"
}Schritt 3: Zahlungsmethode
POST /api/checkout
{
"step": "payment",
"payment_gateway_id": 1
}Schritt 4: Bestellung abschließen
POST /api/checkout
{
"step": "complete"
}Antwort mit Zahlungsumleitung:
{
"success": true,
"data": {
"order_id": 624,
"order_number": "ORD-2024-0624",
"total": 638.90,
"payment_redirect": "https://payment.quickpay.net/..."
}
}Alle Endpunkte
Unsere Produkte
GET /api/productsGET /api/products/{id}GET /api/categoriesGET /api/categories/{id}GET /api/search?q={query}Korb
GET /api/basketPOST /api/basketPUT /api/basket/{id}DELETE /api/basket/{id}Bestellungen
GET /api/order?order_id={id}&chk={hash}Kasse
GET /api/checkoutPOST /api/checkoutGET /api/shippingGET /api/payment-methodsGET /api/countriesInhalt
GET /api/pagesGET /api/pages/{id}GET /api/blogGET /api/blog/{id}GET /api/landing-pagesGET /api/menusGET /api/frontpageGET /api/resolve/{url}Einstellungen und Präferenzen
GET /api/settings