Naar de inhoud
Alle integraties

Eigen REST API

Een klant- of vaksysteem dat geen standaardkoppeling heeft, ontsloten via een begrensde read-only API.

Status
Op aanvraag We bouwen en valideren deze koppeling samen met een eerste klant.
Categorie
Databases en dataplatformen
Richting
Alleen lezen. Reportt schrijft nooit iets terug naar de bron.
Licentie
Geen eigen licentie nodig
Ook gezocht als
API koppeling maken · maatwerk koppeling · vaksysteem koppelen · eigen API

Over de bron

Wat Eigen REST API is

Een REST API is de gangbare manier waarop software gegevens aan andere software beschikbaar stelt: een adres per soort gegeven, een sleutel voor toegang en een vast antwoordformaat. Vrijwel elk modern vaksysteem heeft er een, en dat is de ingang die Reportt gebruikt.

Wat eruit komt

De gegevens die deze bron levert

Elk gegeven dat Reportt hier ophaalt krijgt in het rapport zijn herkomst mee, zodat een lezer kan zien waar een cijfer vandaan komt.

  • De endpoints die jij vrijgeeft
  • Authenticatie via API-sleutel of OAuth
  • Een vast schema per endpoint, zodat velden hun betekenis houden

Zo staat het in het rapport

Systeemnaam, endpoint, identifier van het record en het tijdstip van ophalen.

In het rapport

Waar dit terechtkomt

  • Een vaksysteem dat alleen in jouw branche voorkomt
  • Een intern systeem waar de gegevens voor het rapport in staan

Wat je nodig hebt

Toegang en rechten

Een API waar jij toegang toe geeft, met een sleutel of OAuth. We spreken per endpoint af wat er gelezen wordt.

Waar het ophoudt

Dit bouwen we per klant. Hoeveel werk het is, hangt af van de API: een gedocumenteerde REST-API met een duidelijk schema is een kwestie van inrichten, een ongedocumenteerd systeem is een project.

Veelgestelde vragen over Eigen REST API

Stel je vraag
Wat kost zo’n eigen koppeling?

Dat hangt af van de API. We kijken eerst samen naar de documentatie en zeggen dan wat het is, in plaats van vooraf een bedrag te noemen dat we later moeten terugnemen.

Kan Reportt ook naar onze API schrijven?

Nee. Alle koppelingen van Reportt lezen alleen. Het rapport is de uitkomst; het bronsysteem verandert nooit.

Hoe lang duurt het inrichten?

Een gedocumenteerde API met een duidelijk schema is doorgaans een kwestie van dagen. Zonder documentatie eerst een verkenning; daarna zeggen we wat het wordt.

Welke authenticatie ondersteunen jullie?

API-sleutel, OAuth 2.0 en basic auth over https. Certificaatgebaseerde toegang bespreken we per geval.

Wat ermee gebeurt

De functies die deze bron gebruiken

Een bron is het begin. Dit is wat Reportt vervolgens met deze gegevens doet, elk met zijn eigen pagina.

Neem één bestaand rapport mee

Dan zie je op je eigen dossier wat er uit Eigen REST API in je rapport terechtkomt, en waar het ophoudt.

Daarna upload je je documenten, kies je een sjabloon en draai je je eerste rapport.