Startseite

Stallfreunde API (v1)

Lesender Zugriff auf die Daten deines Stalls für eigene Skripte, zum Beispiel eine tägliche Prüfung, welche Stalldienste offen geblieben sind. Die API funktioniert unabhängig von der App.

Zugang

Jede Anfrage schickt den Token im Header mit:

Authorization: Bearer sf_…

Versionen

Die Version ist Teil des Pfads (/api/v1/…). Innerhalb von v1 kommen höchstens neue Felder und neue Filterwerte dazu; bestehende werden weder umbenannt noch entfernt. Ignoriere also Felder, die du nicht kennst. Eine inkompatible Änderung käme als /api/v2/…, und v1 läuft weiter.

GET /api/v1/tasks

https://bgkidelbtqrzvgfokdfd.supabase.co/functions/v1/api/v1/tasks

Aufgaben mit einem Fälligkeitstag im Zeitraum (Tage in der Zeitzone des Stalls, Europe/Berlin). Aufgaben ohne Fälligkeitstag werden nicht geliefert.

ParameterPflichtWerte
from, tojaYYYY-MM-DD, beide einschließlich, höchstens 31 Tage
stable_duties_onlytrue: nur Aufgaben aus Stalldiensten
stable_duty_idnur die Aufgaben dieses Stalldiensts
statusopen, done, needs_people (offen und noch niemand eingetragen, oder weniger Leute, als der Stalldienst braucht)
assigned_tome, nobody oder die ID einer Person
scopekommagetrennt aus ORGANIZATION (ganzer Stall), HORSE, HORSE_POSITION (Box), RIDING_GROUP, PERSONAL
scope_idID des Pferds, der Box oder der Reitgruppe

Filter schränken das Ergebnis nur ein. Ein unbekannter Parameter oder Wert wird nicht stillschweigend ignoriert, sondern mit 400 abgelehnt.

Beispiel: offene Stalldienste von gestern
curl -s -H "Authorization: Bearer $STALLFREUNDE_TOKEN" 
  "https://bgkidelbtqrzvgfokdfd.supabase.co/functions/v1/api/v1/tasks?from=2026-11-16&to=2026-11-16&stable_duties_only=true&status=open"

Antwort (anonymisiert)

{
  "api_version": 1,
  "orga_id": "6f1c0a52-…",
  "from": "2026-11-16",
  "to": "2026-11-16",
  "generated_at": "2026-11-17T07:00:01.204+00:00",
  "tasks": [
    {
      "id": "a14558cd-95e8-4fbb-8ce9-746b159ead60",
      "title": "Koppelservice morgens",
      "description": "Pferde auf die Koppel bringen und Wasser auffüllen",
      "scope": { "type": "ORGANIZATION", "id": null, "name": null },
      "stable_duty": { "id": "0b6e…", "name": "Koppelservice morgens" },
      "due_date": "2026-11-16",
      "all_day": false,
      "start_time": "08:00",
      "end_time": "09:00",
      "assignees": [
        { "id": "3d2a…", "name": "Vorname", "surname": "Nachname" }
      ],
      "is_done": false,
      "closed_at": null,
      "needs_people": true,
      "created_at": "2026-11-02T03:00:12.551+00:00",
      "updated_at": "2026-11-15T18:21:40.002+00:00"
    }
  ]
}
FeldBedeutung
iddauerhafte ID der Aufgabe
scope.typefür wen die Aufgabe gilt (Werte wie beim Filter scope; neue Werte können dazukommen)
scope.nameName des Pferds, der Box oder der Reitgruppe, sonst null
stable_dutyder Stalldienst, aus dem die Aufgabe stammt, sonst null
due_dateFälligkeitstag (Zeitzone des Stalls)
all_day, start_time, end_timeStalldienste haben die Uhrzeit ihres Diensts, andere Aufgaben gelten ganztägig (start_time/end_time sind dann null)
assigneeseingetragene Personen; name/surname sind null bei Personen, die den Stall verlassen haben
is_done, closed_aterledigt, und wann
needs_peopleoffen, und es fehlen noch Leute

Fehler

Alle Fehler kommen als JSON: { "error": { "code": "…", "message": "…" } }

StatuscodeWann
400invalid_parameterein Parameter fehlt, ist unbekannt oder ungültig (die Meldung sagt, welcher)
401unauthorizedToken fehlt, ist falsch, widerrufen oder abgelaufen, oder das Konto ist nicht mehr im Stall
403missing_scopeder Token darf diesen Endpunkt nicht nutzen
404not_foundunbekannter Pfad oder unbekannte Version
405method_not_allowednur GET (und HEAD)
500internal_errorFehler bei uns; bitte versuche es später noch einmal

Bitte frag höchstens einmal pro Minute ab: für eine tägliche Prüfung reicht ein Aufruf am Tag.