Authentification

Obtenir un jeton d’accès

Fonctionnement

Pour interroger l’API vous avez besoin d’un jeton d’accès, vous pouvez utiliser un jeton que vous pourrez générer depuis l’Espace Client.

Les tokens créés sur l’interface de production ne sont pas utilisables sur la plateforme de développement. Pour vos développement vous pouvez créer vos tokens sur l’espace client de tests.

Pour vos requêtes il faut ajouter un header Authorization et le jeton précédé de :

Token si c’est un jeton généré dans l’application

L’API legacy permet d’obtenir des access token, dans ce cas prefix est différent :

Bearer dans le cas d’un accessToken

Exemple en PHP

Ajoutez le client de l’API à votre projet

composer require infracorp/api-client-extranet

Pour obtenir une instance du client :

<?php

use Infracorp\Extranet\Client as PrizzTelecom;

require_once(__DIR__ . "/vendor/autoload.php");

$config = PrizzTelecom\Configuration::getDefaultConfiguration()
    ->setApiKey('Authorization', 'remplacez par votre token')
    ->setApiKeyPrefix("Authorization", "Token");

$prizzTelecom = new PrizzTelecom\Api\DefaultApi(
    new GuzzleHttp\Client(),
    $config
);

Par défaut le client se connecte à une plateforme de tests, pour passer en production il faudra changer l’hôte de l’objet $config avant le new.

$config->setHost($config->getHostFromSettings(2));

Exemple avec curl

Voici un exemple d’appel cURL par token pour récupérer la liste des entités légales sur lesquelles vous disposez d’un contrat client en cours de validité :

export url_api="https://dev.prizz-telecom.fr/"
export token="abcdefghijklmnopqrstuvwxyz"
curl --location "${url_api}/external-api/v2/legal_entities" --header "Authorization: Token ${token}"

Dans les exemples suivant on assumera que les variables $url_api et $token sont bien définies.