API pour développeurs
L'API permet aux développeurs de récupérer ou de modifier les données des différents outils de l'application Jestyc à partir d'autres applications (sites Internet, applications Excel, applications mobiles, logiciels divers, etc).
L'API permet par exemple de :
- rechercher des données dans un outil et les afficher dans une autre application
- enregistrer des données dans un outil à partir d'une autre application (par exemple un formulaire d'un site Internet)
- etc.
Connexion à l'API
La première étape pour utiliser l'API est de récupérer un token en envoyant votre nom d'utilisateur et votre mot de passe.
Le token généré remplacera ensuite vos identifiants de connexion dans toutes vos prochaines requêtes (il reste valable tant que vos identifiants n'auront pas servi à générer un nouveau token ou à se connecter à l'application Jestyc).
Pour obtenir le token, copiez les données suivantes (au format JSON) et remplacez NOM_UTILISATEUR et MOT_DE_PASSE :
{
"p": {
"login": "NOM_UTILISATEUR",
"password": "MOT_DE_PASSE"
}
}
Envoyez ensuite ces données en POST à :
https://api.jestyc.com/v1/Login
Vous obtiendrez ensuite une réponse au format JSON avec votre token ainsi que votre ID d'utilisateur (ou un code d'erreur si les identifiants sont incorrects) :
{
"token": "d80a06da51ace5bf353e3394cba57dae10a97edd8836c384003e4187bec4385e41",
"user_id": "345"
}
Liste des outils
La seconde étape consiste à récupérer la liste des outils auxquels vous avez accès et leurs ID respectifs.
Envoyez la requête suivante (avec le token récupéré à la première étape) :
{
"p": {
"token": "TOKEN"
}
}
https://api.jestyc.com/v1/ToolsAccess
Vous obtiendrez ensuite la liste des outils auxquels vous avez accès au format JSON :
[
{
"id": "115",
"tool": "2",
"name": "Carnet de contacts 1",
"access": "2"
},
{
"id": "114",
"tool": "2",
"name": "Carnet de contacts 2",
"access": "1"
},
{
"id": "111",
"tool": "1",
"name": "Exemple de notes 1",
"access": "2"
},
{
"id": "113",
"tool": "1",
"name": "Exemple de notes 2",
"access": "2"
}
]
Chaque tableau représente un outil auquel vous avez accès et contiennent les informations suivantes :
id | ID unique de l'outil |
tool | Type d'outil |
name | Nom de l'outil tel qu'il a été défini depuis votre compte |
access | Accès de l'utilisateur |
Requêtes sur un outil
Vous disposez maintenant d'un token et de la liste des ID des outils auxquels vous avez accès, vous pouvez donc effectuer des requêtes sur l'outil de votre choix.
Vous trouverez la liste des requêtes que vous pouvez exécuter sur chaque outil sur la page API outils.