Schnelleinstieg
In wenigen Minuten vom Zugang zum ersten Aufruf gegen die PatriotConnect Partner-API.
Willkommen im Entwicklerportal von PatriotConnect. Hier liegt die Dokumentation der
Partner-API: die als partner freigegebenen /v1-Endpunkte, gerendert aus der
OpenAPI-Spezifikation, dazu Leitfaeden zu Authentifizierung, Scopes, Rate-Limits,
Fehlerformat, Pagination und Versionierung.
Das Portal zeigt nur die Partner-/oeffentliche Fassung der API. Interne Verwaltungs-
und Betriebs-Endpunkte sind nicht Teil dieser Dokumentation und werden serverseitig nie
ausgeliefert. Der Zugang zum Portal selbst liegt hinter dem SSO-Login (Recht
read:api-docs).
In drei Schritten zum ersten Aufruf
1. Zugang besorgen
Du brauchst entweder einen API-Key oder einen OAuth2-Client:
- API-Key —
Authorization: Bearer pc_live_…(Produktion) bzw.pc_test_…(Sandbox). - OAuth2 client_credentials — fuer Server-zu-Server-Integrationen ueber das SSO.
Details und Unterschiede: Authentifizierung.
2. Umgebung waehlen
Zum Ausprobieren steht die Sandbox mit dem Test-Mandanten „Musterpartei" bereit
(staging, naechtlich zurueckgesetzt). Dort gelten ausschliesslich pc_test_-Keys.
Produktion ist im Portal nicht als Ziel waehlbar.
3. Ersten Aufruf machen
curl https://api.sandbox.example/v1/events \
-H "Authorization: Bearer pc_test_DEIN_SCHLUESSEL"Antwort (gekuerzt, erfundene Daten):
{
"data": [
{
"id": "evt_9mKq2pX7",
"title": "Kreisparteitag Musterpartei",
"startsAt": "2026-11-14T18:00:00Z",
"visibility": "public"
}
],
"page": { "nextCursor": "ZXZ0XzlwWA", "hasMore": true }
}Wie geht es weiter?
API-Referenz
Alle freigegebenen /v1-Endpunkte aus der Spec.
Authentifizierung
Bearer-Keys und OAuth2 client_credentials.
Scopes & Ebenen
Berechtigungen und Zugangs-Ebenen.
Beispielaufrufe
Kopierfertige Aufrufe gegen die Sandbox.
Grundlagen auf einen Blick
| Thema | Kurzfassung |
|---|---|
| Basis-URL | https://<host>/v1 (Sandbox: https://api.sandbox.example/v1) |
| Format | JSON; Fehler als application/problem+json (RFC 7807) |
| Zeiten | ISO-8601 in UTC (2026-11-14T18:00:00Z) |
| IDs | oeffentliche NanoIDs (z. B. evt_9mKq2pX7), nie interne Datenbank-IDs |
| Pagination | Cursor-basiert (page.nextCursor) |
| Versionierung | /v1 im Pfad, eingefrorene Fassung je Plattform-Release (CalVer) |