Introduction à l'API REST
L'accès à l'API est disponible uniquement pour les comptes payants ou premium.
Pour commencer, générez un jeton d'autorisation. Ceci peut être fait par l'administrateur principal du compte dans la section : Gestion du compte — Accès API — REST API.
Accès à l'interface
- L'accès à l'interface se fait via le point d'entrée, dont l'adresse est disponible dans la section REST API :
- https://your_account_name.planfix.сom/rest/
- Il existe également un lien vers la spécification REST et un bac à sable pour déboguer les requêtes vers votre compte.
- Les requêtes envoyées depuis la page de spécification de l'API sont exécutées directement dans votre compte, pas sur des données de test.
Veuillez noter
L'accès à l'interface se fait via le protocole HTTPS. Toutes les requêtes utilisant une connexion non sécurisée seront automatiquement ignorées. Nous recommandons de configurer une connexion sécurisée de test avec le point d'accès de l'interface Planfix avant d'envoyer des données.
Limites des requêtes de l'application
- Tous les comptes ont une limite en fonction du forfait payé :
- 20 000 / 50 000 / 100 000 requêtes par jour
- 1 requête par seconde
- Pour les méthodes qui renvoient des listes de valeurs, une limite de 100 résultats par requête est définie.
- Le nombre approximatif de requêtes restantes par jour est retourné dans l'en-tête X-RateLimit-Remaining — la valeur est mise à jour environ toutes les 10 minutes.