Ajouter ou rechercher une suggestion

Anonim

Questions techniques autour de l'API

Bonjour, Quel syntaxe exacte devons-nous utiliser dans l'appel API pour récupérer les factures en fonction d'un mois de l'année ? Est-il possible d'importer dans notre site toutes les factures créées depuis notre abonnement à vos services ? Comment peut-on, lors de l'importation dans notre extranet de factures, importer aussi les données se rapportant aux objets liés par des relations (notamment les données se rapportant au client, au user. Nous n'avons que leurs ID correspondant à votre base de données, je souhaiterais récupérer plus de données sur le client pour le retrouver dans ma base de données et le rattacher à la facture que j'aurai créé. Merci de vos réponses, Christophe Houlet
Réponse principale VosFactures 01/03/2019 16:35

Bonjour,

Vous nous avez laissé un message sur le Tchat de VosFactures.
Vous pouvez actuellement télécharger la liste des factures du mois en cours, à l'aide de la requête suivante :
curl https://votrecompte.vosfactures.fr/invoices.json?period=this_month&api_token=API_TOKEN&page=1

Si vous souhaitez télécharger les documents pour un mois en particulier c'est la variable "this_month" qui doit être modifiée. Si vous souhaitez connaître la variable exacte, je pourrai revenir vers vous en début de semaine prochaine après consultation auprès d'un technicien.

Concernant votre seconde question, vous pouvez télécharger séparément la liste des contacts : 
curl "https://votrecompte.vosfactures.fr.com/clients.json?api_token=API_TOKEN&page=1"

Je vous invite à lire la documentation correspondante ici : https://github.com/vosfactures/api.

Restant à votre disposition,

Commentaires (4)

Customer Reviews

Bonjour, s’il vous plait j’interoge une API de l’application ZK Bio time, pour recupérer la liste des utilisateurs, malheureusement j’ai une erreur (string(58) “{“detail”:”Informations d’authentification non fournies.”}”). voici mon code :

<?php

// Endpoint pour obtenir le token
$token_url = ‘http://127.0.0.1/jwt-api-token-auth/’;

// Informations d’identification pour l’API
$username = ‘admin’;
$password = ‘Api12345678’;

// Données à envoyer avec la requête POST
$post_data = array(
‘username’ => $username,
‘password’ => $password
);

// Initialisation de cURL
$curl = curl_init();

// Configuration de la requête POST
curl_setopt_array($curl, array(
CURLOPT_URL => $token_url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($post_data),
CURLOPT_SSL_VERIFYHOST => false, // Désactiver la vérification du certificat
CURLOPT_SSL_VERIFYPEER => false,
));

// Exécution de la requête et récupération de la réponse
$response = curl_exec($curl);

// Vérification de la réponse
if ($response === FALSE) {
// Gestion des erreurs
echo ‘Erreur lors de la récupération du token : ‘ . curl_error($curl);
} else {
// Analyse de la réponse JSON pour extraire le token
$data = json_decode($response, true);
if (isset($data[‘token’])) {
// Récupération du token
$token = $data[‘token’];

    // Utilisation du token dans une autre requête vers une ressource protégée par l'API
    $resource_url = 'http://127.0.0.1/personnel/api/employees/';
    // Exemple de requête avec le token dans l'en-tête d'autorisation
    $headers = array(
        'Authorization: JWT '.$token
    );

    // Initialisation d'une nouvelle session cURL
    $curl_resource = curl_init();
    curl_setopt_array($curl_resource, array(
        CURLOPT_URL => $resource_url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYHOST => false, // Désactiver la vérification du certificat
        CURLOPT_SSL_VERIFYPEER => false,
    ));

    // Exécution de la requête et récupération de la réponse de la ressource
    $resource_response = curl_exec($curl_resource);

    // Vérification de la réponse de la ressource
    if ($resource_response === FALSE) {
        // Gestion des erreurs
        echo 'Erreur lors de la récupération de la ressource : ' . curl_error($curl_resource);
    } else {
        // Affichage de la réponse de la ressource
        echo 'Réponse de la ressource protégée : ' . $resource_response;

    }

    // Fermeture de la session cURL pour la ressource
    curl_close($curl_resource);
} else {
    // Gestion des cas où le token n'est pas trouvé dans la réponse
    echo 'Token non trouvé dans la réponse';
} }

// Fermeture de la session cURL
curl_close($curl);

?>

Voici la documentation de l’API :

Get JWT Auth Token
#Request
Method: POST

Url: /jwt-api-token-auth/

Headers:

Content-Type: application/json
Body: {
“username”: “username”,
“password”: “password”
}

Request
Method: GET

Url: /personnel/api/employees/
Headers:
Content-Type: application/json
Authorization: “JWT ey………oQi98”

VosFactures

Bonjour,

Pouvez-vous me donner un exemple plus précis ?
Sur une facture vous indiquez le nom du consultant / vendeur, ou bien souhaitez-vous connaître la personne qui a créé la facture ? L'ID utilisateur est indiqué dans l'adresse URL de l'utilisateur, depuis Paramètres > Utilisateurs, après avoir cliqué sur l'adresse email en question.

En attendant votre retour,

Bonjour,

Merci de vos réponses, j’ai bien vu sur GitHub la liste des requêtes disponibles. Une dernière question : comment récupérer sur une facture l’objet correspondant au user_id ? C’est-à-dire la personne rattachée à la facture ? Cela correspond pour nous au consultant, dont le nom figure sur un exemplaire pdf.
Promis après je ne vous embeterais plus,
Cordialement,
Christophe Houlet

VosFactures

Réponse principale

Bonjour,

Vous nous avez laissé un message sur le Tchat de VosFactures.
Vous pouvez actuellement télécharger la liste des factures du mois en cours, à l'aide de la requête suivante :
curl https://votrecompte.vosfactures.fr/invoices.json?period=this_month&api_token=API_TOKEN&page=1

Si vous souhaitez télécharger les documents pour un mois en particulier c'est la variable "this_month" qui doit être modifiée. Si vous souhaitez connaître la variable exacte, je pourrai revenir vers vous en début de semaine prochaine après consultation auprès d'un technicien.

Concernant votre seconde question, vous pouvez télécharger séparément la liste des contacts : 
curl "https://votrecompte.vosfactures.fr.com/clients.json?api_token=API_TOKEN&page=1"

Je vous invite à lire la documentation correspondante ici : https://github.com/vosfactures/api.

Restant à votre disposition,

Ajouter un commentaire