Wanneer je met een externe applicatie (niet zijnde AFAS Profit) wilt koppelen doe je er verstandig aan om de basisgegevens voor het benaderen van de externe applicatie in een HTTP-app vast te leggen. Hierdoor vergemakkelijk je het ophalen en verzenden van informatie van/naar deze externe applicatie en hoef je bepaalde zaken (zoals basis URL, headers, maar ook informatie voor toegangstoken) maar op 1 plaats te definiëren en te onderhouden.
Beheren van HTTP-apps
Wanneer je via het navigatie menu naar Apps gaat en vervolgens kiest voor HTTP kom je in het overzicht scherm terecht waar alle gedefinieerde HTTP-apps in een tabel getoond worden. Hier kun je nieuwe HTTP-apps toevoegen en bestaande HTTP-apps bewerken of verwijderen.
...
Mocht je inmiddels veel HTTP-apps gedefinieerd hebben en het overzicht kwijt zijn dan bestaat er ook nog de mogelijkheid om een HTTP-app te zoeken d.m.v. de zoekbox in de header van het overzicht.
Zie HTTP-app toevoegen/bewerken
...
Het basis request
Een HTTP-app heeft minimaal een naam en een basis request nodig. Het basis request bestaat uit een basis URL (dat deel van de URL dat voor alle API calls naar die externe applicatie identiek is) en eventueel nog header parameters die voor alle API calls benodigd zijn. De basis URL zal bij verder gebruik in U-turn als prefix (voorvoegsel) dienen bij de requests voor het ophalen en versturen van informatie van/naar de externe applicatie.
...
Optioneel (maar bij het koppelen naar de meeste externe applicaties altijd wel benodigd) kan er aangegeven worden dat er een toegangstoken benodigd is bij het gebruik van deze HTTP-app. Wanneer dit benodigd is komt er een extra optie beschikbaar om de geldigheid van het toegangstoken aan te geven (onbeperkt of een x-aantal minuten) en is het vervolgens ook mogelijk om het toegangstoken request te definiëren.
...
Het toegangstoken request
Voor het verkrijgen van een toegangstoken dient een specifieke URL van de externe applicatie aangeroepen te worden. In dit deel van het scherm kun je dus de request method (GET, POST of PUT), de te gebruiken URL, benodigde header parameters en eventueel een body definitie opgeven.
...
Nadat alle benodigde informatie voor het toegangstoken request ingegeven zijn dient het request getest te worden om vervolgens het te gebruiken toegangstoken samen te kunnen stellen. Nadat je op de button geklikt hebt wordt het request uitgevoerd en krijg je het request response te zien.
Vervolgens kun je aangeven waar in het basis request het toegangstoken gebruikt moet worden (op dit moment ondersteunen we enkel nog gebruik in de header) en dient er een waarde voor de key en waarde ingevuld te worden. Bij het definiëren van de waarde kan informatie uit het request response gebruikt worden door de naam van het betreffende veld tussen { } te plaatsen.
...
voor informatie over het toevoegen en bewerken van een HTTP-app.