Skip to content

Où en est l'API

Il n’y a pas encore d’API REST publique. Les routes /v1 ne sont pas livrées : aucune adresse ne répond aujourd’hui, et appeler /v1/notes renvoie une erreur de route inconnue. Cette page dit exactement ce qui existe, pour que vous ne cherchiez pas ailleurs.

Depuis le 11 novembre 2026, une personne peut créer une clé d’API personnelle dans Paramètres > Connecteurs > Clés d’API (bureau). L’iPhone les liste et les révoque, sans les créer : un secret se colle dans un outil, donc depuis un ordinateur.

Forme kpn_ suivi de 43 caractères
Ce qui est conservé Le SHA-256 du secret, jamais le secret : il s’affiche une fois
Ce que montrent les listes Le préfixe (les 12 premiers caractères), pour reconnaître une clé
Clés actives 20 au plus par personne
Validité 30 jours, un an (par défaut) ou sans expiration
Révocation Immédiate et définitive
Offre api (Pilote, Pro, Business) pour créer ; lister et révoquer reste possible en Free

Une clé reçoit les mêmes droits que le MCP (notes:read, notes:write, contacts:write, transcripts:read, files:read, calendar:read) plus webhooks:manage. Une clé ne peut ni en créer une autre ni se révoquer : les routes qui les gèrent (GET, POST, DELETE /me/api-keys) n’acceptent que les jetons de l’application.

Une clé ne sert à rien pour l’instant. Elle est faite pour les routes à venir : la créer aujourd’hui ne donne accès à rien, et c’est normal.

Ce qui est posé côté serveur, et invisible

Section titled “Ce qui est posé côté serveur, et invisible”

Le socle est en place, sans route publique pour l’utiliser :

  • une garde qui authentifie Authorization: Bearer kpn_…, refuse une clé inconnue, révoquée ou expirée (401), un compte suspendu, une offre sans le droit api (403 plan_required, vérifiée à chaque appel) et un droit manquant (403 insufficient_scope) ;
  • une limite de débit par clé : 600 lectures et 60 écritures par minute, avec X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, et 429 rate_limited au-delà ;
  • les schémas publics versionnés (v1) : une note, un kalepin, un compte rendu, un enregistrement, une transcription, un espace, une action, une erreur.

Dans l’ordre : les routes /v1 en lecture (notes, kalepins, espaces, enregistrements, transcriptions, compte rendu, actions, avec pagination par curseur et filtre updatedSince), puis l’écriture, puis la référence interactive de cette page — générée depuis les mêmes schémas, pour qu’elle ne puisse pas mentir.

En attendant, les deux portes utilisables sont le serveur MCP et les webhooks.