Einstieg

3 Seiten

Stand: 6. November 2026

Einführung

APRO ist die modulare Kassenplattform für Restaurant, Hotel, Foodtruck oder Systemgastronomie — offen für alles, was du brauchst. Von Hotelsoftware über Buchhaltung, Zahlungs- und Zutrittssysteme bis zu Reservierungs- und Lieferdiensten: APRO verbindet sich nahtlos mit deiner bestehenden Systemlandschaft, für durchgängige Prozesse und maximalen Automatisierungskomfort.

Diese Seite richtet sich an Entwicklungsteams, die auf dieser Oberfläche aufbauen: Partner mit Reservierungs- oder Warenwirtschaftssystemen, Lieferplattformen, die Bestellungen in die Kassa einsteuern, BI-Tools mit Lesezugriff auf den Belegbestand oder interne Teams, die Reports automatisieren.

Was Sie hier finden

  • REST-APIs. Stabile JSON-über-HTTPS-Endpunkte für die unten genannten Bereiche. Jeder Endpunkt wird über einen einzigen API-Key authentifiziert — kein SDK erforderlich, kein OAuth-Flow zu orchestrieren.
  • SQL-Views. Lesende Views für direkten Datenbankzugriff, ideal für BI-Pipelines und Data Warehouses.
  • Payload-Beispiele. Jedes Beispiel auf dieser Seite liegt zusätzlich als eigenständige JSON-Datei unter /samples/ vor und kann direkt heruntergeladen und abgespielt werden.
  • Vollständige API-Referenz. Der maschinenlesbare Vertrag ist unter api-docs.apro.at veröffentlicht.

Wählen Sie Ihren Einstieg

Ziel

Hier starten

Umsätze, Belege und Zahlungen abfragen

Umsatz API

Bestellungen von extern einspielen

Externe Bestellung API

Menükarten lesen oder bearbeiten

Menükarten API

Daten für BI / Warehouse exportieren

SQL Views

Anfragen signieren

Authentifizierung

Status und Versionierung

Endpunkte unter /api/v1/… gelten als stabil. Breaking Changes werden in den Release Notes auf apro.at angekündigt. Neue optionale Felder und nicht-brechende Ergänzungen in Antworten können jederzeit dazu kommen — Parser sollten unbekannte Keys tolerieren.

Support

  • Vertrieb & Onboarding: apro.at/support
  • Integrationsfragen: über Ihre APRO-Ansprechperson.

Authentifizierung

Alle APRO-REST-Endpunkte verwenden einen einzigen API-Key, übergeben im Request-Header x-api-key. Es gibt keinen OAuth-Flow und kein Token-Refresh — Keys sind langlebig und auf einen Mandanten oder einen einzelnen Standort beschränkt.

Header

POST /api/v1/external/order HTTP/1.1
Host: my.apro.at
x-api-key: sk_live_pLpXZq8S…
content-type: application/json

Key-Scope

Jeder APRO-REST-Key ist an einen Standort gebunden. Ein Request ist nur erfolgreich, wenn der aus dem Endpunkt abgeleitete Standort mit dem Standort des Keys übereinstimmt.

Endpunkt-Stil

Standort wird abgeleitet aus

POST /api/v1/reports/receipts

dem API-Key selbst.

POST /api/v1/locations/{location}/reports/receipts

{location} in der URL — muss mit dem Key-Standort übereinstimmen.

Ein standortgebundener Key versagt sicher, wenn er gegen einen anderen Standort verwendet wird, und ist unbedenklich an Partner oder ein einzelnes Deployment weiterzugeben.

Key beziehen

Keys werden vom APRO Account-Team ausgestellt. Anfrage an Ihre Ansprechperson oder an apro.at/support. Rotation wird unterstützt; der abgelöste Key bleibt eine Karenzzeit lang gültig, damit Sie ohne Ausfall umziehen können.

Keys aufbewahren

  • Niemals in das Versionskontrollsystem einchecken.
  • Keys in einem Secret Manager speichern (Azure Key Vault, 1Password, HashiCorp Vault, GitHub-Actions- oder Azure-DevOps-Secrets).
  • Zur Laufzeit als Umgebungsvariable (APRO_API_KEY) einspielen.

Fehlerantworten

Status

Bedeutung

401 Unauthorized

x-api-key-Header fehlt oder ist ungültig.

403 Forbidden

Key gültig, aber nicht für Standort oder Aktion berechtigt.

429 Too Many Requests

Rate-Limit erreicht. Mit exponentiellem Backoff erneut versuchen.