API - Parametereinstellung

Was passiert, wenn ich die optionalen Parameter nicht übergebe?

Nur die Medien-URL ist erforderlich — genau eine von image_url oder video_url. Alles andere im Body (region_id, model, species, priors, latitude, longitude, country) ist eine optionale Überschreibung.

Wenn Sie einen Parameter weglassen, greift die API auf die Standardeinstellungen des Kontos zurück, zu dem der API-Schlüssel gehört — dieselben Einstellungen, die Sie in TrailCamHub konfiguriert haben. Eine einfache Anfrage wird also genauso analysiert, wie es in Ihrem eigenen Konto der Fall wäre.

Konkret gilt bei Auslassung:

• region_id / model → die Standardregion Ihres Kontos und das Modell dieser Region (eu oder global).

• species → die Artenliste für diese Region plus Ihre Profilfavoriten — d. h. Ihre Positivliste.

• priors → die Arten, die Sie in Ihrem Profil als "am wahrscheinlichsten" markiert haben.

• latitude / longitude / country (nur globales Modell) → der für Ihre Region konfigurierte Standort.

Das bedeutet, dass der einfachste mögliche Aufruf trotzdem funktioniert und sich sinnvoll verhält:

json

{ "image_url": "https://example.com/photo.jpg" }

Überschreibungen gelten pro Aufruf. Jeder Parameter, den Sie senden, überschreibt die Standardeinstellung nur für diese einzelne Anfrage — er ändert niemals Ihr gespeichertes Profil. Übergeben Sie model, species oder Koordinaten, wenn eine bestimmte Kamera oder ein bestimmter Standort von Ihren Standardeinstellungen abweicht; lassen Sie sie weg, um Ihre Kontoeinstellungen zu verwenden.

Tipp: Wenn alle Ihre Anfragen dieselbe Region und dieselben Arten verwenden, richten Sie diese einmalig in Ihrem TrailCamHub-Profil ein und senden Sie minimale Anfragen. Wenn Sie Kameras in verschiedenen Regionen oder Gebieten verarbeiten, übergeben Sie bei jedem Aufruf die relevanten Überschreibungen (region_id, model, species, Koordinaten), damit jedes Bild im richtigen Kontext analysiert wird.