Ein einfacher E-Commerce-Ablauf: Produkte durchsuchen, Warenkorb erstellen, Gutscheine einlösen und zur Kasse gehen. Nicht verfügbare Artikel liefern den Fehlercode 409, ungültige Gutscheine den Fehlercode 422 und abgelaufene Gutscheine den Fehlercode 410. Der Checkout berücksichtigt den Idempotenzschlüssel, sodass Wiederholungsversuche nie doppelt berechnet werden.
Basis-URL: https://funapi.dev/api/shop/v1 · 12 Endpunkte · OpenAPI-3.1-Spezifikation und Postman-Collection verfügbar. Neu hier? Lesen Sie die Einstiegsanleitung.
Dinge, die Sie nicht brauchen
GET /shop/v1/products — Produkte auflisten, nach Kategorie filtern · Antwortet mit 200 Link zu diesem EndpunktGET /shop/v1/products/{id} — Holen Sie sich ein Produkt · Antwortet mit 200 404 Link zu diesem Endpunkthinzufügen, entfernen, bereuen
POST /shop/v1/carts — Einen leeren Warenkorb erstellen · Antwortet mit 201 400 Link zu diesem EndpunktGET /shop/v1/carts/{id} — Lassen Sie sich den Warenkorb mit dem aktuellen Gesamtbetrag anzeigen. · Antwortet mit 200 404 Link zu diesem EndpunktPOST /shop/v1/carts/{id}/items — Produkt hinzufügen (409, wenn nicht vorrätig) · Antwortet mit 200 400 404 409 Link zu diesem EndpunktDELETE /shop/v1/carts/{id}/items/{productId} — Ein Produkt aus dem Warenkorb entfernen · Antwortet mit 200 404 Link zu diesem Endpunktwo das Geld vorgibt, sich zu bewegen
GET /shop/v1/coupons/{code} — Einen Coupon validieren (410, wenn abgelaufen) · Antwortet mit 200 404 410 Link zu diesem EndpunktPOST /shop/v1/carts/{id}/checkout — Schauen Sie sich das an (idempotent, couponfähig) · Antwortet mit 201 400 404 409 422 Link zu diesem EndpunktGET /shop/v1/orders/{id} — Bestellen Sie jetzt! · Antwortet mit 200 404 Link zu diesem EndpunktPOST /shop/v1/reservations — Bestand reservieren, ohne zu überverkaufen (erfordert Bearer-Auth) · Antwortet mit 201 400 401 404 409 422 Link zu diesem EndpunktGET /shop/v1/reservations/{id} — Den Ablauf einer Bestandsreservierung beobachten · Antwortet mit 200 410 400 401 404 409 422 Link zu diesem EndpunktPOST /shop/v1/reservations/{id}/confirm — Reservierten Bestand anhand seiner Version verbrauchen (erfordert Bearer-Auth) · Antwortet mit 200 410 412 400 401 404 409 422 Link zu diesem EndpunktDie Shop-API ist ein Checkout-Prozess: Produkte mit realen Lagerbeständen, Warenkörbe und ablaufende Gutscheine. Der Lagerbestand wird beim Checkout reduziert, daher treten die relevanten Fehler zwischen dem Hinzufügen eines Artikels und der Bezahlung auf – genau das Zeitfenster, das die meisten E-Commerce-Testumgebungen auslassen.
GET https://funapi.dev/api/shop/v1/products — Produkte auflisten, nach Kategorie filtern. Kein Token, keine Anmeldung:
curl -i https://funapi.dev/api/shop/v1/products
Antwort: 200 OK
{
"total": 6,
"data": [
{
"id": 1,
"name": "Rubber Duck (QA Edition)",
"price": 9.99,
"stock": 12,
"category": "office"
},
{
"id": 2,
"name": "Mechanical Keyboard, Extra Clicky",
"price": 129,
"stock": 5,
"category": "office"
},
{
"id": 3,
"name": "Limited Sneaker Drop",
"price": 249.99,
"stock": 0,
"category": "fashion"
},
{
"id": 4,
"name": "Coffee Beans, 1kg, Depressingly Strong",
"price": 18.5,
"stock": 40,
"category": "food"
},
{
"id": 5,
"name": "HTTP Status Cats Poster",
"price": 14,
"stock": 7,
"category": "decor"
},
{
"id": 6,
"name": "Infinite TODO Notebook",
"price": 11.25,
"stock": 3,
"category": "office"
}
]
}
Diesen Endpunkt öffnen und ausführen
Zuletzt aktualisiert