Soms geven API’s niet alle regels terug, maar bijvoorbeeld alleen de eerste honderd regels. Om deze reden is het dan nodig om de data op te halen in delen totdat alle regels opgehaald zijn. Wanneer een API slechts een deel van de regels in één keer aanbiedt zal er in de response vaak een property te vinden zijn op basis waarvan een nieuw verzoek kan worden samengesteld.
Vanuit het bouwblok waarmee je data op kan halen zijn twee onderdelen beschikbaar waar informatie uitgehaald kan worden. Dit kan bijvoorbeeld een bepaalde response header zijn, maar ook een property uit de response body.
Deze twee onderdelen zijn:
response → Type is System.Net.WebResponse (https://learn.microsoft.com/en-us/dotnet/api/system.net.webresponse?view=net-8.0 )
responseResult → Type is dynamic (graag link naar documentatie MS)
In de invoervelden van het type waarde of berekening kunnen deze onderdelen vervolgens gebruikt worden (in het berekeningen gedeelte). Voorbeelden hiervan zijn response.Headers["Content-Type"] en responseResult.total_items.
Voorbeeld Mailchimp data ophalen in delen.
Mailchimp heeft een API die niet standaard alle regels aanbiedt, hierbij dien je dus zelf door het resultaat heen te lopen om alle regels op te halen. De manier om bijvoorbeeld alle members uit een list op te halen ziet er als volgt uit:
https://{mailchimpServer}/3.0/lists/{listId}/members?count={number_of_rows}&offset={offset}
Hierbij is {mailchimpServer} de specifieke Mailchimp server, {listId} de ID van de lijst die je op wil halen, {number_of_rows} het aantal regels dat in één keer opgehaald wordt, en offset het paginanummer (beginnend bij 0).
Het bouwblok in U-Turn Studio ziet er als volgt uit:
Er zijn drie query parameters aanwezig, list_id, count en offset. De query parameter ‘count’ is gevuld met de koppelingsvariabele {{items_per_page}}, hierin staat het aantal per pagina: