Basit bir e-ticaret akışı: ürünlere göz atın, sepet oluşturun, kuponları uygulayın ve ödeme yapın. Stokta olmayan ürünler 409 hatası, geçersiz kuponlar 422 hatası, süresi dolmuş kuponlar 410 hatası döndürür ve ödeme işlemi Idempotency-Key özelliğini kullandığı için tekrar denemelerde asla çift ücretlendirme olmaz.
Temel URL: https://funapi.dev/api/shop/v1 · 12 uç nokta · OpenAPI 3.1 belgesi ve Postman koleksiyonu mevcut. Yeni misiniz? Önce şunu okuyun: başlangıç rehberi.
ihtiyacınız olmayan şeyler
GET /shop/v1/products — Ürünleri listele, kategoriye göre filtrele · Yanıt kodları: 200 Bu uç noktanın bağlantısıGET /shop/v1/products/{id} — Bir ürün alın · Yanıt kodları: 200 404 Bu uç noktanın bağlantısıeklemek, kaldırmak, pişman olmak
POST /shop/v1/carts — Boş bir sepet oluşturun · Yanıt kodları: 201 400 Bu uç noktanın bağlantısıGET /shop/v1/carts/{id} — Toplam tutarı gösteren bir alışveriş sepeti alın. · Yanıt kodları: 200 404 Bu uç noktanın bağlantısıPOST /shop/v1/carts/{id}/items — Ürün ekle (stokta yoksa 409) · Yanıt kodları: 200 400 404 409 Bu uç noktanın bağlantısıDELETE /shop/v1/carts/{id}/items/{productId} — Sepetten bir ürünü çıkarın · Yanıt kodları: 200 404 Bu uç noktanın bağlantısıparanın hareket ediyormuş gibi davrandığı yer
GET /shop/v1/coupons/{code} — Kuponu geçerli kılın (süresi dolmuşsa 410) · Yanıt kodları: 200 404 410 Bu uç noktanın bağlantısıPOST /shop/v1/carts/{id}/checkout — (İdempotent, kuponlara duyarlı) ürünlere göz atın. · Yanıt kodları: 201 400 404 409 422 Bu uç noktanın bağlantısıGET /shop/v1/orders/{id} — Sipariş verin · Yanıt kodları: 200 404 Bu uç noktanın bağlantısıPOST /shop/v1/reservations — Fazla satış yapmadan stok ayırın (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 201 400 401 404 409 422 Bu uç noktanın bağlantısıGET /shop/v1/reservations/{id} — Stok rezervasyonunun süresinin dolmasını gözlemleyin · Yanıt kodları: 200 410 400 401 404 409 422 Bu uç noktanın bağlantısıPOST /shop/v1/reservations/{id}/confirm — Ayrılmış stoğu sürümünü kullanarak tüketin (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 200 410 412 400 401 404 409 422 Bu uç noktanın bağlantısıShop API'si bir ödeme işlemidir: gerçek stok sayılarına sahip ürünler, sepetler ve süresi dolan kuponlar. Stok, ödeme sırasında azalır, bu nedenle ilginç hatalar, bir ürün ekleme ve ödeme yapma arasında meydana gelir; bu da çoğu e-ticaret test paketinin atladığı zaman dilimidir.
GET https://funapi.dev/api/shop/v1/products — Ürünleri listele, kategoriye göre filtrele. Token yok, kayıt yok:
curl -i https://funapi.dev/api/shop/v1/products
Yanıt: 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"
}
]
}
Son güncelleme