Erste Schritte
TheCatAPI ist eine REST-API mit Rassedaten, Bildern und Fotoanalyse für Apps rund um Katzen. Damit baust du Tierprofile, Gesundheitschecks und Rasseinhalte für Halter, oder du ergänzt ein Versicherungs-, Tierarzt- oder Tiernahrungsprodukt um Rassedaten.
1. API-Schlüssel holen
Registriere dich, und wir schicken dir einen Schlüssel per E-Mail. Sende ihn bei jeder Anfrage im Header x-api-key. Details findest du unter Autorisierung, und Staging- und Produktionskonten erklärt, wie du testest, ohne Live-Daten anzufassen.
2. Erste Anfrage senden
curl -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/breeds/abys
{
"id": "abys",
"name": "Abyssinian",
…
}
Alle Endpunkte liegen unter https://api.thecatapi.com/v1. Wenn etwas schiefgeht, erklärt Fehler und Limits jeden Statuscode und wann sich ein neuer Versuch lohnt.
3. Wähle, was du baust
| Du möchtest … | Starte mit |
|---|---|
| Rassedetails, Fakten und Gesundheitstipps zeigen | Rassedaten für Halterinhalte |
| Katzenbilder durchsuchen oder Nutzer eigene hochladen lassen | Bilder und Bild-Uploads |
| Jedem Halter ein Profil für sein Tier geben | Ein Haustier anlegen, dann Haustiere mit Nutzern verknüpfen |
| Rasse, Alter oder Gewicht aus Fotos bestimmen | Rasse erkennen, Alter schätzen, Gewicht schätzen |
| Den Ernährungszustand prüfen, mit tierärztlicher Prüfung | Body Condition Score |
| Tägliche Kalorien oder einen Abnehmplan empfehlen | Tägliche Kalorien und Abnehmplan |
| Eine Gesundheitsakte über die Zeit führen | Gesundheitsverlauf eines Haustiers |
| Ergebnisse an deinen Server senden lassen | Webhooks |
Die Übersicht der Leitfäden listet alle Leitfäden. Die API-Referenz listet jeden Endpunkt und jedes Feld.
Tarife
Der Free-Tarif ist zum Lernen und für Hobbyprojekte. Der Startup-Tarif bringt eine kommerzielle Lizenz, höhere Anfragelimits und den vollständigen Rassedatensatz zu einem niedrigen Monatspreis. Enterprise-Tarife schalten Fotoanalyse, Gesundheitsakten und die Rechner frei.
Rassemerkmale (Temperament, Herkunft, Lebenserwartung, Fell und Eigenschaftswerte von 1 bis 5) und Fakten sind im Startup-Tarif enthalten. Gesundheitstipps, Ernährungsrisiken und -empfehlungen, Allergene, Pflege- und Bewegungshinweise, Witze, Fotoanalyse und Porträts gehören zu Enterprise.
Was für deinen Schlüssel freigeschaltet ist, zeigt GET /accounts/features oder der Leitfaden Was eingeschaltet ist. Kontaktiere uns zu Enterprise-Zugang und Preisen.