Comment obtenir une clé d'API et appeler l'API ?
L'app, votre propre Claude et vos scripts appellent tous la même API REST, avec les mêmes rôles. Une clé commence par fsk_, appartient à un seul espace de travail et n'a jamais plus de droits que la personne pour laquelle elle agit. Envoyez-la sous la forme Authorization: Bearer <key> à https://app.filmsquare.ai/v1.
Créer une clé personnelle #
Une clé personnelle fonctionne pour tout rôle.
- Ouvrez Settings, puis Claude.
- Choisissez Use a personal key instead.
- Donnez-lui un Name of the key et choisissez Create a personal key.
- Copiez la clé. Elle n'est affichée qu'une seule fois.
Pour la tester :
curl -s "https://app.filmsquare.ai/v1/me" -H "Authorization: Bearer $FS_KEY"
Une clé personnelle peut faire ce que votre rôle permet, sauf gérer les clés. Pour l'arrêter, choisissez Disconnect sur la même page.
Créer une clé d'espace de travail #
Un producer ou un owner peut créer, via l'API, des clés avec un rôle choisi, y compris pour un utilisateur agent. Le rôle ne peut jamais être supérieur au vôtre, et l'appel doit venir d'une session connectée : une clé personnelle ou une connexion Claude ne peut pas créer de clés. La requête et les routes de liste et de révocation figurent dans la documentation sous a workspace API key.
Trouver toutes les routes #
La référence complète est un document OpenAPI public à l'adresse https://app.filmsquare.ai/v1/openapi.json. Consultez la référence OpenAPI pour savoir comment la lire, et l'aperçu de l'API pour les erreurs que vous rencontrerez. Pour être prévenu quand une prise est prête au lieu d'interroger l'API en boucle, voir recevoir un webhook quand une prise est prête.