Page Comparison

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.

In zo’n geval heeft de externe bron meestal de mogelijkheid om in de aanroep (URL) te specificeren dat je een specifiek segment/pagina wilt ophalen van de data. U-Turn Studio ondersteunt de mogelijkheid om dit bij een bron op te geven.

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"] (hierbij wordt een specifieke header uit de response uitgelezen) en responseResult.total_items(dit is de property ‘total_items’ in de response body).

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}10&offset={offset}0

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).

...

if 'offset' not in locals():
    offset = 0
    page_number = 0

#Property in de body waar het totaal aantal items in staat
total_items = responseResult.total_items

resultIteration = False
items_per_page = {{items_per_page}}

if(total_items!=None):
    total_items_numeric = int(total_items)
    page_number+=1
    offset = page_number*int(items_per_page)

    if offset<total_items_numeric:
        resultIteration = True
    else:
        resultIteration = False

resultIteration

Het resultaat van de twee bovenstaande berekeningen is dat de query parameter ‘offset’ steeds opgehoogd wordt, totdat het aantal opgehaalde regels gelijk is aan total_items. Per API zal deze property mogelijk anders heten. Zorg dat je op regel 6 (responseResult.total_items) de waarde aanpast naar de property in de response die het aantal regels aangeeft.