HTTP-gegevensacties maken

U kunt een HTTP-API-gegevensactie gebruiken in een werkmap. Wanneer u vervolgens een kolom selecteert, wordt de waarde naar een REST-API verstuurd en wordt een respons geretourneerd.

Voordat u een HTTP-API-gegevensactie maakt, moet u het domein waarmee u verbinding probeert te maken als een veilig domein configureren. Zie voor meer informatie: Veilige domeinen registreren.

  1. Ga op de beginpagina met uw muis op een werkmap staan en klik op Acties. Selecteer vervolgens Openen.
  2. Klik in de werkmap op Menu en selecteer vervolgens Gegevensacties.
  3. Klik op Actie toevoegen en voer een naam in voor de HTTP API-gegevensactie. Voer bijvoorbeeld HTTP API Voorbeeld in.
  4. Klik op het veld Type en selecteer HTTP API.
  5. Klik op het veld Verankeren aan en selecteer de kolommen waarop u de HTTP API-gegevensactie wilt toepassen. Selecteer geen eenheidkolommen of verborgen kolommen. Als u geen waarde opgeeft voor het veld Verankeren aan, is de gegevensactie van toepassing op alle gegevenselementen in de visualisaties.
  6. Selecteer een methode in de lijst HTTP-methode.
  7. Voer de URL voor de REST-API in. Deze begint met http of https en bevat eventueel vervangingstokens.
  8. Als u de POST-methode hebt geselecteerd, doet u het volgende:
    • Wanneer u bij Payloadtype de waarde 'Formuliergegevens' selecteert, voert u elke parameter op een afzonderlijke regel in.
    • Wanneer u bij Payloadtype de waarde 'Ruwe gegevens' selecteert, voert u de ruwe gegevens in.
  9. Voer een aangepaste HTTP-koptekst in als u een HTTP-koptekst wilt toevoegen aan de API waarmee u werkt, of als u de HTTP-koptekst van de API wilt overschrijven.
  10. Klik op Ondersteunt meervoudige selectie om de waarde in te stellen.
    • Aan: de gegevensactie kan worden opgeroepen wanneer er een of meer gegevenspunten zijn geselecteerd.
    • Uit: de gegevensactie kan alleen worden opgeroepen wanneer er één gegevenspunt is geselecteerd.

      Deze instelling is vooral nuttig wanneer de selectie van meerdere gegevenspunten mogelijk leidt tot een fout (bijvoorbeeld bij sommige REST-API's van derden).

  11. Klik op OK om op te slaan.
  12. Klik op een gegevenspunt in de visualisatie.

    Bijvoorbeeld: selecteer 'Boeken' in een tokencategoriekolom om een bepaalde REST-API weer te geven.

  13. Klik met de rechtermuisknop en selecteer HTTP API Voorbeeld om het resultaat weer te geven.

    De geselecteerde gegevenspunten bepalen welke waarden worden doorgegeven aan de URL-tokens.

    Er wordt een bericht over succes of mislukking weergegeven waarmee wordt bevestigd dat de REST-API is aangeroepen met de geselecteerde waarde.