Premiers pas
Authentification
Chaque requête porte un jeton bearer dans l’en-tête Authorization. Une clé d’API appartient à un seul espace de travail : un propriétaire ou un administrateur la crée sous Connexions dans cet espace, elle commence par pc_, n’est affichée qu’une fois et agit avec un accès administrateur sur cet espace et rien d’autre. Gardez-la hors du code côté client ; sa révocation prend effet immédiatement, tout comme la perte du rôle d’administrateur par son créateur.
Un jeton d’accès OAuth issu du flux du connecteur MCP fonctionne dans le même en-tête. Il est lié à l’espace de travail que la personne a choisi en se connectant, avec ses propres droits. Dans les deux cas, un identifiant ouvre exactement un espace de travail, et tout ce qui suit s’y limite.
Une première requête
curl https://usepaperclerk.com/api/v1/templates \
-H "Authorization: Bearer pc_YOUR_TOKEN"