Exemples d'utilisation en PHP

Pour vous simplifier l'utilisation de l'API en PHP, commencez par copier le code de la class JestycApi et créez le fichier "JestycApi.php".

Si vous ne disposez pas d'une fonction d'autoload, ajoutez la ligne suivante avant de faire appel à la class JestycApi (sans oublier de modifier le chemin du fichier) :

require_once __DIR__.'/JestycApi.php';

Récupérer le token

Le code suivant vous permet de récupérer le token dans la variable $token :

// Données de la requête
$data = [
    'p' => [
        'login' 	=> 'NOM_UTILISATEUR',
        'password' 	=> 'MOT_DE_PASSE',
    ]
];

// URL de la requête
$url = 'https://api.jestyc.com/v1/Login';

// API
$api = new JestycApi($data, $url);
$api->execute();

// Exit en cas d'erreur (pour simplifier la gestion des erreurs dans l'exemple)
if (!$api->success())
    exit;

// Token
$token = $api->getResponseValue('token');

Pour déboguer votre code et afficher les différentes données en cas d'erreur, vous pouvez utiliser :

echo $api->debug();

Récupérer la liste des outils

Le code suivant (que vous pouvez ajouter à la suite du précédent) vous permet de récupérer la liste des outils et leurs données :

// Données de la requête
$data = [
    'p' => [
        'token' 	=> $token
    ]
];

// URL de la requête
$url = 'https://api.jestyc.com/v1/ToolsAccess';

// API
$api = new JestycApi($data, $url);
$api->execute();

// Exit en cas d'erreur (pour simplifier la gestion des erreurs dans l'exemple)
if (!$api->success())
    exit;

A partir de là, vous pouvez obtenir différentes informations en fonction de vos besoins, telles qu'obtenir le nombre d'outils, parcourir les tableaux des outils, récupérer les informations des outils (ID, type, nom, accès), etc.

Pour obtenir le nombre d'outils :

$count = $api->countResponse();

Pour obtenir le tableau du premier outil :

$array0 = $api->getResponseValue(0);

Pour obtenir l'ID du premier outil :

$id0 = $api->getResponseValue(0)['id'];

Pour faire une boucle pour chaque outil :

foreach ($api->getResponse() as $array)
    var_dump($array);

Rechercher et récupérer des contacts

Le code suivant (que vous pouvez ajouter à la suite du premier) vous permet de rechercher et récupérer la liste des contacts correspondants.

Dans cet exemple, l'objectif est de récupérer la liste des contacts dont le champ "Email" contient une adresse email et de trier ces données en fonction du 5e champ :

// Données de la requête
$data = [
    'p' => [
        'token' 	=> $token, // Token
        'tool_id' 	=> 115, // ID de l'outil
        'search_9' 	=> '@', // Recherche dans le 10e champ (Email)
        'order_by' 	=> 4 // Trier en fonction du 5e champ (Entreprise)
    ]
];

// URL de la requête
$url = 'https://api.jestyc.com/v1/Contacts';

// API
$api = new JestycApi($data, $url);
$api->execute();

// Exit en cas d'erreur (pour simplifier la gestion des erreurs dans l'exemple)
if (!$api->success())
    exit;

// Boucle pour chaque contact
foreach ($api->getResponse() as $array)
    var_dump($array);

Pour obtenir le nombre de contacts trouvés :

$count = $api->countResponse();

Ajouter un nouveau contact

Le code suivant (que vous pouvez ajouter à la suite du premier) vous permet d'ajouter un nouveau contact :

// Données de la requête
$data = [
    'p' => [
        'token' 	=> $token, // Token
        'tool_id' 	=> 115 // ID de l'outil
    ],
    'd' => [
        'data_2'	=> 'Exemple', // Nom
        'data_3' 	=> 'Test', // Prénom
        'data_9' 	=> 'exemple@test.com', // Email
        'data_29' 	=> 'Ceci est un exemple.' // Remarques
    ]
];

// URL de la requête
$url = 'https://api.jestyc.com/v1/ContactWrite';

// API
$api = new JestycApi($data, $url);
$api->execute();

// Exit en cas d'erreur (pour simplifier la gestion des erreurs dans l'exemple)
if (!$api->success())
    exit;

Pour obtenir l'ID du nouveau contact :

$contactId = $api->getResponseValue('contact_id');
Il ne s'agit ici que de quelques exemples ... Vous trouverez la liste des requêtes que vous pouvez exécuter sur chaque outil sur la page API outils (ainsi que les paramètres de chaque requête et un exemple de valeurs de retour).