Cette section vous aide à commencer à utiliser l’API Teable rapidement et en toute sécurité.
URL de base
- Teable Cloud :
https://app.teable.ai
- Auto-hébergé : utilisez votre propre domaine (par exemple,
https://teable.example.com)
Tous les chemins d’API de cette documentation sont relatifs à l’URL de base et commencent par /api.
Authentification
Les API Teable utilisent des jetons Bearer :
Vous pouvez utiliser l’un des deux éléments suivants :
- Jeton d’accès personnel : idéal pour les scripts, les outils internes et les intégrations côté serveur. Consultez Jeton d’accès.
- Jeton d’accès OAuth : idéal pour les intégrations multilocataires dans lesquelles les utilisateurs finaux accordent l’accès. Consultez Application OAuth.
ID (spaceId / baseId / tableId / viewId / fieldId / recordId)
La plupart des points de terminaison nécessitent des ID tels que tbl..., rec.... Consultez Obtenir les identifiants.
Portées et autorisations
Les jetons d’accès personnels et les jetons OAuth sont tous deux limités par des autorisations. Si vous obtenez une erreur 403, cela signifie généralement que le jeton ne dispose pas de la portée requise.
De nombreux points de terminaison de liste prennent en charge :
take : nombre d’éléments à renvoyer (certains points de terminaison imposent une limite ; par exemple, les Enregistrements sont limités à 100 par requête, utilisez donc skip pour paginer)skip : nombre d’éléments à ignorer
Certaines API vous permettent de contrôler la représentation des Champs d’Enregistrement :
fieldKeyType : name (par défaut) / id / dbFieldNamecellFormat : json (par défaut) / text
Pour les structures de valeurs des Champs d’Enregistrement, consultez Interface des Champs d’Enregistrement.
Étapes suivantes
Dernière modification le 4 septembre 2026
