Bir kafe tezgahı API'si: içecekleri inceleyin, sipariş verin ve gururla HTTP 418 "I'm a teapot" yanıtını döndüren GET /teapot isteğini gönderin.
Temel URL: https://funapi.dev/api/coffee/v1 · 6 uç nokta · OpenAPI 3.1 belgesi ve Postman koleksiyonu mevcut. Yeni misiniz? Önce şunu okuyun: başlangıç rehberi.
sıcak ve soğuk
GET /coffee/v1/drinks — İçecekleri listele, türe göre filtrele · Yanıt kodları: 200 400 Bu uç noktanın bağlantısıGET /coffee/v1/drinks/{id} — Bir içecek alın. · Yanıt kodları: 200 404 Bu uç noktanın bağlantısıkupanın üzerindeki isim
POST /coffee/v1/orders — Bir içecek sipariş edin. · Yanıt kodları: 201 400 Bu uç noktanın bağlantısıPUT /coffee/v1/orders/{id}/ready — Siparişi hazır olarak işaretleyin (zaten hazırsa 409). · Yanıt kodları: 200 404 409 412 Bu uç noktanın bağlantısıGaza bas ve 429'ları izle.
GET /coffee/v1/rush-hour — Yoğun saatlere özel indirim — 10 saniyelik periyotlarda en fazla 3 istek. · Yanıt kodları: 200 429 Bu uç noktanın bağlantısıRFC 2324 uyumluluğu
GET /coffee/v1/teapot — Çaydanlıkta kahve demlemeyi deneyin. · Yanıt kodları: 418 Bu uç noktanın bağlantısıCoffee Shop API'si, kataloğun hız sınırlama oyun alanı ve HTTP 418'in yuvasıdır. Hızlı erişim uç noktası gerçek bir kota uygular: kotayı aşarsanız, Retry-After ve canlı pencerede yenilenen olağan X-RateLimit başlıklarıyla birlikte 429 hatası alırsınız. İstemci tarafı kısıtlama ve geri çekilme, düzgün çalışan bir API'ye karşı test edilmesi neredeyse imkansızdır ve bu API istek üzerine yanlış davranır.
GET https://funapi.dev/api/coffee/v1/drinks — İçecekleri listele, türe göre filtrele. Token yok, kayıt yok:
curl -i https://funapi.dev/api/coffee/v1/drinks
Yanıt: 200 OK
{
"total": 8,
"data": [
{
"id": 1,
"name": "Espresso",
"type": "hot",
"price": 2.5
},
{
"id": 2,
"name": "Latte",
"type": "hot",
"price": 4
},
{
"id": 3,
"name": "Cappuccino",
"type": "hot",
"price": 3.8
},
{
"id": 4,
"name": "Flat White",
"type": "hot",
"price": 4.2
},
{
"id": 5,
"name": "Cold Brew",
"type": "cold",
"price": 4.5
},
{
"id": 6,
"name": "Iced Matcha Latte",
"type": "cold",
"price": 4.8
},
{
"id": 7,
"name": "Mocha",
"type": "hot",
"price": 4.4
},
{
"id": 8,
"name": "Turkish Coffee",
"type": "hot",
"price": 3
}
]
}
Son güncelleme