Güçleri, takımları ve düşmanları olan özgün kahramanlar ve kötü adamlar. İç içe kaynaklar ( /heroes/{id}/nemesis ), filtreleme ve rol tabanlı kimlik doğrulama uygulamaları.
Temel URL: https://funapi.dev/api/superheroes/v1 · 6 uç nokta · OpenAPI 3.1 belgesi ve Postman koleksiyonu mevcut. Yeni misiniz? Önce şunu okuyun: başlangıç rehberi.
pelerinler, güçler ve onların yeminli düşmanları
GET /superheroes/v1/heroes — Kahramanları listele (sayfalandırılmış, filtrelenebilir) · Yanıt kodları: 200 400 404 Bu uç noktanın bağlantısıGET /superheroes/v1/heroes/{id} — Bir kahraman edinin · Yanıt kodları: 200 404 Bu uç noktanın bağlantısıGET /superheroes/v1/heroes/{id}/nemesis — Kahramanın düşmanını elde et (iç içe geçmiş kaynak) · Yanıt kodları: 200 404 Bu uç noktanın bağlantısıPOST /superheroes/v1/heroes — Yeni bir kahraman kaydedin (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 201 400 401 Bu uç noktanın bağlantısıDELETE /superheroes/v1/heroes/{id} — Kahraman olarak emekli ol (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 204 401 403 404 412 Bu uç noktanın bağlantısıPOST /superheroes/v1/heroes/versus — İki kahraman arasında bir dövüşü simüle edin. (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 201 400 401 Bu uç noktanın bağlantısıSuperhero API'si, katalogdaki en küçük kaynak ağacıdır ve iç içe rotaları uygulamak için en açık olanıdır: kahramanlar güçlere sahiptir ve güçler düz bir koleksiyonda değil, kahramanlarının altında adreslenir. Ebeveyn kimliklerinden URL'ler oluşturması gereken bir istemci yazıyorsanız veya ebeveynlerden önce çocukları temizlemesi gereken testler yazıyorsanız, bu, üzerinde pratik yapmanız gereken yapıdır.
GET https://funapi.dev/api/superheroes/v1/heroes — Kahramanları listele (sayfalandırılmış, filtrelenebilir). Token yok, kayıt yok:
curl -i https://funapi.dev/api/superheroes/v1/heroes
Yanıt: 200 OK
{
"page": 1,
"pageSize": 4,
"total": 8,
"totalPages": 2,
"data": [
{
"id": 1,
"name": "Captain Volt",
"alias": "Deniz Aksoy",
"power": "electricity",
"team": "Alpha Squad",
"nemesisId": 5,
"_v": 1
},
{
"id": 2,
"name": "Night Owl",
"alias": "Sam Reyes",
"power": "night vision",
"team": "Alpha Squad",
"nemesisId": 6,
"_v": 1
},
{
"id": 3,
"name": "Aqua Comet",
"alias": "Mira Chen",
"power": "hydrokinesis",
"team": "Freelance",
"nemesisId": null,
"_v": 1
},
{
"id": 4,
"name": "Turbo Tortoise",
"alias": "unknown",
"power": "super speed (eventually)",
"team": "Freelance",
"nemesisId": 7,
"_v": 1
}
]
}
Son güncelleme