Utilisation de l'API
Identification
$ curl --basic --user APIKEY: https://api.alwaysdata.com/v1/account/
Vos tokens sont disponibles dans le menu Profil.
Avertissement
Pour l’utilisation de vos tokens, n’oubliez pas les deux points (:) après la clé, ce qui permet de préciser que le mot de passe n’est pas nécessaire.
Information
Une limite du nombre de requêtes à l’API s’applique. Plus d’informations ici.
Ressources liées
Si vous accédez à des ressources liées à un utilisateur ou un compte spécifique, vous devez le spécifier lors de votre authentification en utilisant un des paramètres suivants:
- account : il s’agit du compte auquel vous désirez accéder. Si par exemple vous avez plusieurs comptes mais souhaitez accéder à une ressource d’un compte précis.
- customer : si vous disposez de certaines permissions sur un autre utilisateur, alors vous devez spécifier son adresse email.
Par exemple, accédez aux utilisateurs FTP de votre compte mycompany de cette manière :
$ curl --basic --user "APIKEY account=mycompany:" https://api.alwaysdata.com/v1/ftp/
Format
Les formats gérés sont les suivants :
Il peut être spécifié dans l’URI :
$ curl --basic --user APIKEY: https://api.alwaysdata.com/v1/account/?_format=xml
Ou via le header HTTP :
$ curl --basic --user APIKEY: --header 'Accept: application/xml' https://api.alwaysdata.com/v1/account/
En-têtes HTTP
En-tête HTTP | Description | Valeur par défaut |
---|---|---|
alwaysdata-synchronous | Exécution des requêtes en mode synchrone | no |
Rate-limit
Une limite d’actions par minute est mise en place :
- 10 requêtes par minute
- 50 requêtes pour les connexions permanentes
- 250 requêtes pour les méthodes safe comme
GET