1

Obtenez un document

getfile

GET https://bezillion.com/api/v1/getfile/id?login=&password=

id est l'identifiant unique d'un fichier dans votre index, e.g. 01234567-89ab-cdef-01234-56789abcdef.

loginVotre code d'identification.
passwordVotre mot de passe.
textRenvoi du texte indexé.

text : 1 - texte en clair extrait du document. IMPORTANT : Si le document a été indexé avec le paramètre stored=0, le texte en clair n'est pas disponible.

The quick brown fox
jumps over
the lazy dog.

Indexez le fichier :

$ curl -s --fail --show-error -X POST "https://bezillion.com/api/v1/indexfile?login=abcdef&password=ABCDEF" -F "file=@fox.txt" -o -
{"status":"success","data":{"id":"6e4f9696-4e67-4b2a-afcb-c5d1b0c42430"}}

Notez l'identifiant du fichier retourné dans le champ id : 6e4f9696-4e67-4b2a-afcb-c5d1b0c42430.

Obtenez tous les champs et le texte du fichier dans l'index :

$ curl -s --fail --show-error -X DELETE "https://bezillion.com/api/v1/getfile/6e4f9696-4e67-4b2a-afcb-c5d1b0c42430?login=abcdef&password=ABCDEF&text=1"
{"status":"success","data":{id:"6e4f9696-4e67-4b2a-afcb-c5d1b0c42430","file":"fox.txt","size":45,"stored":true,"date":"2026-05-13T11:00:00Z","from":"local","lang":"en","text":"The quick brown fox\njumps over\nthe lazy dog.\n"}}

Si l'identifiant du fichier est invalide, le service retourne l'erreur HTTP/1.1 400 Bad Request.

Si aucun fichier ne correspond dans l'index à l'identifiant spécifié, le service retourne un échec :

{"status":"fail","data":null}

Téléchargez le code de la fonction sendget de la librairie iZend. Copiez le fichier dans l'espace de votre application.

NOTE : Reportez-vous à la page Appelez l'API du service pour une description de la fonction sendget.

Ajoutez le fichier getfile.php avec le contenu suivant :

  1. require_once 'sendhttp.php';

Charge le code de la fonction sendget.

  1. function getfile($login, $password, $id, $text=false) {

Définit la fonction getfile.php. $login est votre code d'identification. $password est votre mot de passe. $id est l'identifiant unique d'un fichier dans votre index. Si text vaut true, le texte du fichier est retourné.

  1.     $curl = 'https://bezillion.com/api/v1/getfile/' . urlencode($id);

Met $curl à l'URL de l'action getfile de l'API avec l'identifiant du fichier.

  1.     $args = array(
  2.         'login'     => $login,
  3.         'password'  => $password,
  4.         'text'      => $text
  5.     );

Prépare la liste des arguments du GET : le code d'identification et le mot de passe du compte de l'utilisateur, le renvoi ou non du texte indexé.

  1.     $response=sendget($curl, $args);

Envoie la requête HTTP avec sendget. L'argument $id est déjà dans $curl.

  1.     if (!$response or $response[0] != 200) {
  2.         return false;
  3.     }

Si $response vaut false, le serveur est inaccessible. Si $response[0] ne contient pas le code de retour HTTP 200 Ok, une erreur d'exécution s'est produite. En cas d'erreur, getfile retourne false.

  1.     $r=json_decode($response[2], true);

Décode les données retournées en JSON.

  1.     if ($r['status'] == 'success') {
  2.         return $r['data'];
  3.     }

Retourne le résultat de la recherche si l'action a réussi.

  1.     return false;
  2. }

Retourne false en cas d'échec.

EXEMPLE

En supposant que vous avez sauvé les fichiers sendhttp.php et getfile.php dans le répertoire courant, lancez PHP en mode interactif, chargez la fonction getfile et appelez-la avec en arguments votre code d'identification et votre mot de passe, l'identifiant du fichier fox.txt dans votre index :

$ php -a
php > require_once 'getfile.php';
php > $r=getfile('abcdef', 'ABCDEF', '6e4f9696-4e67-4b2a-afcb-c5d1b0c42430');
php > print_r($r);
Array
(
    [id] => 6e4f9696-4e67-4b2a-afcb-c5d1b0c42430
    [file] => fox.txt
    [size] => 45
    [stored] => 1
    [date] => 2026-05-13T11:00:00Z
    [from] => local
    [lang] => en
    [text] => The quick brown fox
jumps over
the lazy dog.

)

NOTE : Si getfile retourne false, éditez le code pour afficher $response.

VOIR AUSSI

Appelez l'API du service, Indexez un document, Recherchez un document

Commentaires