1
 14

Appelez l'API du service

Pour exécuter une action sur tesseractor.com, vous envoyez simplement une requête HTTP à l'adresse https://tesseractor.com/api suivie du nom de l'action et d'une série de paramètres :

https://tesseractor.com/api/action?login=abcdef&password=ABCDEF

Vous DEVEZ utiliser une connexion HTTPS pour garantir la confidentialité de votre code d'identification et de votre mot de passe, et implicitement, des fichiers échangés avec le service. Dans le cas contraire, la requête retourne un code HTTP 301 Moved Permanently. Le certificat du serveur a été signé par Let's Encrypt.

action vaut getcredit et login et password sont votre code d'identification et votre mot de passe. Selon l'action, plus de paramètres peuvent être nécessaires.

Votre code d'identification en 6 lettres minuscules est affiché en gras sur votre page d'accueil. Pour changer votre mot de passe, appuyez sur le bouton pour accéder à la configuration de votre compte dans la barre de menu.

Essayez d'entrer https://tesseractor.com/api/getcredit?login=abcdef&password=ABCDEF dans la barre d'adresse de votre navigateur en remplaçant abcdef et ABCDEF par votre code d'identification et votre mot de passe.

IMPORTANT : N'oubliez pas d'effacer l'historique du navigateur après un test d'une URL avec votre code d'identification et votre mot de passe.

API

Pour appeler tesseractor.com par programme, il vous faut une fonction capable d'envoyer une requête HTTP à un serveur et de récupérer les données retournées. Téléchargez le fichier sendhttp.php et copiez-le dans l'espace de votre propre application.

Le fichier sendhttp.php définit les fonctions sendget et sendpost.

Lisez la page sendhttp de la documentation sur iZend pour plus de détails techniques.

sendget
sendpost
SYNOPSIS

sendget($url, $args)

sendpost($url, $args, $files=false, $base64=false)

DESCRIPTION

sendget envoie une requête GET à un serveur HTTP à l'adresse spécifiée par $url avec les paramètres dans $args.

sendpost retourne le document renvoyé par l'appel du service HTTP à l'adresse $url en POST avec les arguments $args et les pièces jointes $files encodées en base64 si $base64 vaut true.

$url est une chaîne de caractères avec le format https://tesseractor.com/api/actionaction désigne la fonction demandée telle que getcredit.

$args est un tableau contenant la liste des valeurs des paramètres de la fonction appelée tel que array( 'login' => 'abcdef', 'password' => 'ABCDEF', ... ).

$files contient la liste des fichiers ajoutés en pièces jointes sous la forme d'un tableau associatif { 'docname' => {'name' => 'filename', 'type' => 'mimetype', 'tmp_name' => 'pathname'}, ... }. Ce paramètre est optionnel. Typiquement, il permet de passer un fichier transmis par une balise <input type="file" name="docname"... /> d'un formulaire HTML. Si $base64 est à true, les contenus des fichiers sont encodés en base64.

sendget et sendpost retournent un tableau contenant le code HTTP, l'en-tête et le corps du document renvoyés par le serveur ou false en cas d'erreur.

EXEMPLE

En supposant que vous avez placé le fichier sendhttp.php dans le répertoire courant, lancez PHP en mode interactif, chargez la fonction sendget et appelez-la avec en argument l'URL https://tesseractor.com/api/getcredit et un tableau contenant votre code d'identification et votre mot de passe :

$ php -a
php > require_once 'sendhttp.php';
php > $r=sendget('https://tesseractor.com/api/getcredit', array('login' => 'abcdef', 'password' => 'ABCDEF'));
php > echo $r[0] == 200 ? $r[2] : 'HTTP ERROR ' . $r[0];
5
php > quit
VOIR AUSSI

Vérifiez votre crédit

Commentaires

Pour ajouter un commentaire, cliquez ici.