API-Übersicht

Die Poliscope API v2 bietet programmatischen Zugriff auf alle Plattform-Daten.

Base URL

https://api.poliscope.de/v2

Die vollständige Endpunkt-Liste mit allen Parametern und Antwortschemata findest du in der Referenz, generiert aus der OpenAPI-Spec.

Schnelleinstieg

curl -H "Authorization: Bearer DEIN_API_KEY" \
  -H "x-client: mein-firmenname-integration" \
  https://api.poliscope.de/v2/meetings

API-Schlüssel kannst du unter Einstellungen → API erstellen. Details siehe Authentifizierung.

Konventionen

• Antworten sind JSON, Listen unter data, Metadaten unter meta. Siehe Paginierung.
• Fehler haben ein einheitliches { error, message }-Format. Siehe Fehler.
• Rate-Limits gelten pro API-Schlüssel und liefern x-ratelimit-*-Header. Siehe Rate-Limits.
• Stabilität: v2 ist stabil, additive Änderungen jederzeit möglich. Siehe Versionierung.

Client-Identifikation

Sende bei jeder Anfrage den x-client-Header mit einem eindeutigen Bezeichner für deine Anwendung — z. B. firmenname-produktname oder firmenname-script-xyz. Der Header hilft uns, Anfragen bei Support und Troubleshooting zuzuordnen.