TRIMEDIXSCRM / TESTOMGEVINGFictieve klantgegevens

VAN ZOEKVRAAG NAAR ANTWOORD

Maak de koppeling.

Zoek een klant in het CRM en ontdek wat er tussen jouw app en de API gebeurt.

01 Zoeken → 02 Selecteren → 03 Begrijpen

Verbinding met het CRM

Vul het adres van jouw lokale of gepubliceerde API in.

Lokaal: http://127.0.0.1:8789 · online: https://crm-api.trimedixs.nl

KLANTGEGEVENS

Wie heb je bezocht?

GET
Probeer:

Klaar om te zoeken. Kies een voorbeeld of vul een zoekterm in.

Het begint met een klant.

Zoek in de fictieve klantgegevens van Trimedixs.

ZELF AAN DE SLAG MET DE API

Van Swagger naar jouw eigen app

Swagger is interactieve API-documentatie. Je ziet welke verzoeken mogelijk zijn en probeert ze uit zonder eerst code te schrijven. De OpenAPI-specificatie beschrijft dezelfde afspraken in JSON voor ontwikkeltools en AI.

Open Swagger ↗Bekijk OpenAPI (JSON) ↗
Deze links volgen het API-basisadres bovenaan. Je hebt geen API-sleutel nodig.
  1. Controleer de verbinding. Open Swagger, klap GET /api/v1/status open en kies Try it out → Execute. Je verwacht status 200 en "status": "ok".
  2. Zoek een huisartsenpraktijk. Open GET /api/v1/customers, kies Try it out, vul bij search de waarde huisarts in en klik op Execute. Met K-1001 zoek je één specifieke klant.
  3. Lees het antwoord. Bij Request URL staat het volledige adres. De parameter search staat achter ?. Bij Response body staat JSON: de lijst customers, het aantal treffers total en limit. Er zijn 232 fictieve organisaties; per antwoord zie je maximaal 20. Verfijn je zoekterm bij meer treffers.
  4. Vergelijk met deze client. Zoek hier dezelfde klant en vergelijk het verzoek en JSON-antwoord rechts. Selecteer een klant: customerId is de vaste verwijzing die je in je eigen app bij een declaratie bewaart, samen met de bedrijfsnaam.
  5. Oefen de uitzonderingen. Zoek op bestaatniet: een lege lijst met 200 is geen fout. Probeer in Swagger GET /api/v1/examples/error voor een bewuste 503. Gebruik hieronder Ongeldige zoekterm voor 400; Swagger kan te korte invoer al vóór het versturen tegenhouden.
  6. Bouw het zelf. Open rechts Voorbeeld voor jouw app. Neem de aanroep over, pas de zoekterm aan en gebruik URLSearchParams voor spaties en bijzondere tekens. Controleer response.ok vóór je de JSON verwerkt. Toon een laadstatus, geen-resultatenmelding en foutmelding. Bewaar de selectie vervolgens bij de declaratie in je eigen database; deze client doet dat niet.
Zelfcheck: kun je dit zonder de voorbeeldclient?
  • Ik kan een klant opzoeken vanuit mijn eigen app en uitleggen wat de URL en zoekparameter doen.
  • Ik kan het klantnummer, de bedrijfsnaam en plaats uit de JSON halen.
  • Ik kan het verschil laten zien tussen geen treffers (200), ongeldige invoer (400) en de oefenfout (503).
  • Ik kan een klant bij een declaratie opslaan en na herladen terugzien.
  • Ik heb de koppeling ook vanaf mijn gepubliceerde app via HTTPS getest, zonder API-sleutel of credentials.

TEST OOK WAT ER MIS KAN GAAN

Een goede koppeling kan tegen een fout.

Bekijk het verschil tussen geen treffers, ongeldige invoer en een API die een fout teruggeeft.