Erste Schritte
Authentifizierung
Jede Anfrage trägt ein Bearer-Token im Authorization-Header. Ein API-Schlüssel gehört zu genau einem Arbeitsbereich: Ein Inhaber oder Administrator erstellt ihn unter Verbindungen in diesem Arbeitsbereich, er beginnt mit pc_, wird einmal angezeigt und handelt mit Administratorzugriff auf diesen Arbeitsbereich und sonst nichts. Halten Sie ihn aus clientseitigem Code heraus; ein Widerruf wirkt sofort, ebenso der Verlust der Administratorrolle seines Erstellers.
Ein OAuth-Zugriffstoken aus dem Ablauf des MCP-Connectors funktioniert im selben Header. Es ist an den Arbeitsbereich gebunden, den die Person beim Verbinden gewählt hat, mit ihren eigenen Rechten. So oder so öffnet ein Zugangsdatum genau einen Arbeitsbereich, und alles Weitere ist darauf beschränkt.
Eine erste Anfrage
curl https://usepaperclerk.com/api/v1/templates \
-H "Authorization: Bearer pc_YOUR_TOKEN"