HTTP-API-gegevensacties maken

U kunt HTTP-API-gegevensacties maken om verbinding te maken met een REST-API vanuit een werkmap.

U configureert een HTTP-API-gegevensactie om geselecteerde kolomwaarden uit een werkmap door te geven aan een REST-API zodat een respons wordt geretourneerd. Let hierbij op het volgende:

  • Er is geen limiet voor het aantal gegevensacties dat u kunt maken.

  • Een URL kan tokens bevatten waarmee contextuele waarden worden doorgegeven aan een gegevensactie, bijvoorbeeld gegevenswaarden, een gebruikersnaam, een werkmappad en een canvasnaam.

    Het volgende voorbeeld van een REST-API-URL bevat een tokenwaarde voor de kolom 'Categorie' om de API van Google Books weer te geven: http://www.googleapis.com/books/v1/volumes?q=${valuesForColumn:"Categorie"}. De waarde die u selecteert in een cel van de kolom 'Categorie', bijvoorbeeld "Boeken", wordt doorgegeven aan de REST-API en de aangevraagde pagina wordt weergegeven.

  • Als u een POST-methode gebruikt of als u een aangepaste HTTP-koptekst gebruikt die de HTTP-koptekst overschrijft, is het volgende van toepassing:

    • Voer elke parameter in als een naam-waardepaar waarbij de naam en waarde worden gescheiden door '='.
    • U kunt dezelfde URL-tokensyntaxis in de naam-waardeparen gebruiken zoals vereist in de API die u aanroept. Bijvoorbeeld:
      • paramName1=paramValue1
      • paramName2=${valuesForColumn:"Product"}
    • Een aangepaste koptekst werkt als het specifiek is toegestaan voor het doel van de HTTP-aanvraag dat de HTTP-kopteksten die u gebruikt mogen worden ingesteld voor de aanvraag. Als de kopteksten niet zijn toegestaan, wordt de aanvraag geblokkeerd en wordt een foutmelding in de browser weergegeven. Een cookiekoptekst die Content-Type=application/json bevat, wordt bijvoorbeeld geblokkeerd.