Originelle Helden und Schurken mit Kräften, Teams und Erzfeinden. Übe verschachtelte Ressourcen ( /heroes/{id}/nemesis ), Filterung und rollenbasierte Authentifizierung.
Basis-URL: https://funapi.dev/api/superheroes/v1 · 6 Endpunkte · OpenAPI-3.1-Spezifikation und Postman-Collection verfügbar. Neu hier? Lesen Sie die Einstiegsanleitung.
Umhänge, Kräfte und ihre Erzfeinde
GET /superheroes/v1/heroes — Heldenliste (paginiert, filterbar) · Antwortet mit 200 400 404 Link zu diesem EndpunktGET /superheroes/v1/heroes/{id} — Hol dir einen Helden · Antwortet mit 200 404 Link zu diesem EndpunktGET /superheroes/v1/heroes/{id}/nemesis — Hol dir den Erzfeind eines Helden (verschachtelte Ressource) · Antwortet mit 200 404 Link zu diesem EndpunktPOST /superheroes/v1/heroes — Registriere einen neuen Helden (erfordert Bearer-Auth) · Antwortet mit 201 400 401 Link zu diesem EndpunktDELETE /superheroes/v1/heroes/{id} — Als Held in den Ruhestand gehen (erfordert Bearer-Auth) · Antwortet mit 204 401 403 404 412 Link zu diesem EndpunktPOST /superheroes/v1/heroes/versus — Simuliere einen Kampf zwischen zwei Helden. (erfordert Bearer-Auth) · Antwortet mit 201 400 401 Link zu diesem EndpunktDie Superhero-API ist der kleinste Ressourcenbaum im Katalog und eignet sich am besten zum Üben verschachtelter Routen: Helden besitzen eigene Kräfte, und diese Kräfte werden unterhalb des jeweiligen Helden adressiert, anstatt in einer flachen Liste. Wenn Sie einen Client entwickeln, der URLs aus übergeordneten IDs erstellen muss, oder Tests, die untergeordnete Elemente vor den übergeordneten bereinigen müssen, ist dies die ideale Struktur zum Üben.
GET https://funapi.dev/api/superheroes/v1/heroes — Heldenliste (paginiert, filterbar). Kein Token, keine Anmeldung:
curl -i https://funapi.dev/api/superheroes/v1/heroes
Antwort: 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
}
]
}
Diesen Endpunkt öffnen und ausführen
Zuletzt aktualisiert