Découvrir l'API Infomaniak

Ce guide présente les possibilités qui sont offertes par l'API Infomaniak. 

Préambule

• l’API Infomaniak vous permet de profiter de tout le potentiel de l’écosystème Infomaniak dans vos applications et à l’aide du langage de votre choix
• l'API Infomaniak est une API REST ; le protocole utilisé est HTTP, les requêtes et les réponses sont encodées au format JSON ; l'authentification est réalisée via le protocole OAuth 2
• l'accès et l'utilisation de l'API Infomaniak sont totalement gratuits

Protocole d'utilisation de l'API Infomaniak

À l'aide de l'API vous serez en mesure d'automatiser un large éventail d'actions et de tâches sur les produits et services Infomaniak, sans avoir à utiliser les interfaces produits. Quelques exemples d'utilisation : 

• stocker des données
• envoyer des campagnes de publipostages
• diffuser du flux vidéo ou radio
• commander ou gérer des produits
• et bien plus encore !

P.ex pour un Service Mail : gestion des boîtes mails, gestion des alias, gestion des réponses automatiques, gestion des dossiers, etc.

Créer vos premières requêtes avec l'API Infomaniak

Lire la documentation en anglais uniquement sur les possibilités qui sont offertes par l'API.

Format des requêtes

L'API Infomaniak est une API REST. Le protocole utilisé est l'HTTP, les requêtes et les réponses sont encodées en JSON. L'authentification est réalisée via le protocole OAuth 2.

Pour lancer une requête il est nécessaire d'utiliser la syntaxe suivante : /{version}/{command_path}. Il est possible de ne pas indiquer la version, mais dans ce cas ce sera la dernière version qui sera appliquée.

Pour prendre connaissance de l'ensemble des requêtes disponibles avec l'API Infomaniak, consulter cette page.

Codes de réponses de l'API

Lors de l'utilisation de l'API Infomaniak, vous pourrez être amené à rencontrer différents codes de réponses de celle-ci. Ces codes vous indiquent précisément l'état de votre requête.

Vous retrouvez depuis cette page la liste complète.

Limites & Restrictions

Il existe une limite de 60 requêtes par minutes avec l'API Infomaniak. Cette limite ne peut pas être augmentée.

L'utilisation de l'API est restreinte aux produits qui sont listés dans la documentation officielle. Des ajouts réguliers de produits et services sont effectués dans celle-ci. 

Si le produit ou service qui vous intéresse se trouve dans la documentation, vous pourrez utiliser les requêtes suivantes : GET ; POST ; PATCH ; PUT ; DELETE.

En savoir plus

• Générer et gérer les tokens API
• API Infomaniak : Protocole d'utilisation
• API Infomaniak : Documentation
• API Newsletter
• Make your first request using Curl
• Make your first request using PostMan

Liste complète des tutoriels (cliquer ici)