Gegevens kan je ophalen langs de GET-methode. Dit is de techniek die je ook gebruikt wanneer je eenvoudigweg een URL doorgeeft in een webbrowser.
Je kan dus bijvoorbeeld /api/v1/clients opgeven in een webbrowser om een lijst in XML te krijgen van alle klanten. Een ander voorbeeld: /api/v1/invoices/1001/payments. Wat een lijst teruggeeft met alle betalingen van factuur met ID 1001.
Zoals eerder vermeld kan je het formaat aanpassen waarin de verkregen gegevens worden teruggegeven. Voeg hiervoor de extensie bijvoorbeeld ‘?format=json’ toe aan de URL. De mogelijke formaten zijn xml, json, csv en html.
Een voorbeeld in PHP hoe je gegevens kan ophalen:
$email = 'luc@mymail.com';
$password = '123456';
$p = curl_init('https://eenvoudigfactureren.be/api/v1/clients');
curl_setopt($p, CURLOPT_USERPWD, $email . ':' . $password);
curl_setopt($p, CURLOPT_RETURNTRANSFER, TRUE);
$xml_string_all_clients = curl_exec($p);Indien je een verkeerde URL opgeeft omdat bijvoorbeeld de gevraagde klant niet bestaat dan krijg je als response ook een XML (of het gevraagde formaat) terug met de reden van de fout.
Vraagt je bijvoorbeeld de gegevens aan voor de onbestaande klant met ID 1001 met URL /api/v1/clients/1001 dan krijg je terug:
<data> <error>client_id unknown</error> </data>