Stable Pro API · v1
Stable Pro API
Lesen Sie die wirtschaftlichen Vorgänge eines Stalls – Belastungen, Korrekturen, Zahlungen, Guthaben, Quittungen –, um Rechnungen in Ihrem eigenen Programm auszustellen.
Stable Pro ist die Verwaltungssoftware für Reitställe. Sie führt die wirtschaftlichen Vorgänge jedes Stalls: was jeder Kunde schuldet (Belastungen), jede Korrektur daran (Korrekturen), das eingenommene und das erstattete Geld (Zahlungen), das Guthaben der Kunden und die Quittungen von Stable Pro.
Mit der API können Rechnungs- und Buchhaltungsprogramme diese Vorgänge lesen und eigene Dokumente ausstellen: Rechnungen, Gutschriften, Steuermeldungen. Stable Pro stellt nie Steuerdokumente aus; das tut Ihr Programm. Ein Vertrag für jedes Programm und jedes Land: Es gibt kein Modul für ein bestimmtes Programm und kein Feld, das nur für ein Land gilt.
Was Sie bauen können
- Rechnungsstellung: Belastung lesen, Rechnung ausstellen; Korrektur lesen, Gutschrift ausstellen; Zahlung lesen, Rechnung als bezahlt markieren.
- Synchronisierung: Lesen Sie das Ereignisprotokoll (
GET /events) ab Ihrem gespeicherten Cursor und verarbeiten Sie, was sich seit dem letzten Mal geändert hat. - Abgleich: Lesen Sie Listen, gefiltert nach Kunde oder Buchungsmonat, und vergleichen Sie sie mit Ihrer Buchhaltung.
Schnellstart
- Der Inhaber des Stalls erstellt in Stable Pro eine Verbindung (Einstellungen → Verbindungen) und gibt Ihnen ihren Schlüssel. Ein Testschlüssel beginnt mit
sp_test_und funktioniert in der Staging-Umgebung, mit Testdaten (siehe Testumgebung). - Rufen Sie die API mit dem Schlüssel auf:
curl https://staging.stable-pro.com/api/v1/organization \
-H "Authorization: Bearer sp_test_…"
- Lesen Sie die Geschichte des Stalls von Anfang an, dann lesen Sie ab Ihrem Cursor weiter:
curl "https://staging.stable-pro.com/api/v1/events?limit=100" \
-H "Authorization: Bearer sp_test_…"
Jedes Ereignis verweist auf ein Objekt (data.url): Lesen Sie es, verarbeiten Sie es und speichern Sie next_cursor, wenn die Seite fertig ist.
Basis-URLs
| Umgebung | Basis-URL | Schlüssel |
|---|---|---|
| Produktion | https://app.stable-pro.com/api/v1 | sp_live_… |
| Staging, mit Testdaten | https://staging.stable-pro.com/api/v1 | sp_test_… |
Weiterlesen
- Authentifizierung und Berechtigungen
- Konventionen: Beträge, Datumsangaben, Codes, Listen und Filter, Sprachen
- Ereignisse: synchron bleiben
- Fehler
- Referenz: jeder Endpunkt und jedes Feld, aus dem OpenAPI-Vertrag generiert