Firm settings - Integration

API-instellingen

Cloud integreren met externe applicaties met behulp van API-clients. U kunt maximaal 50 API-klanten aanmaken voor uw bedrijf. We raden aan om één applicatie per API-client te integreren.

Klantgegevens van geïntegreerde applicaties worden automatisch bijgewerkt in Cloud door het gebruik van API-tokens. API-tokens worden door bedrijfsontwikkelaars gebruikt om het integratieproces te authenticeren.

Om een nieuwe API-client aan te maken:

1. Zorg ervoor dat u de beheerdersrol voor instellingen of gelijkwaardige rechten hebt.

2. Selecteer in het menu Cloud () Instellingen | Integratie | API-instellingen.

3. Kies API-client aanmaken.

   

4. Vul in het dialoogvenster ‘API-client aanmaken’ elk tabblad in:

   • Algemeen: Voer een alias in voor de API-client.

   • Functies: Selecteer de relevante rollen voor de API-client. Als beste praktijk raden wij u aan de toegekende rollen te beperken tot hetgeen strikt noodzakelijk is. Raadpleeg „Ingebouwde rollen” voor meer informatie over rolrechten.

   • Apps: Selecteer de relevante apps voor de API-client en geef aan of deze alleen-lezen-toegang of volledige toeganghebben.

5. Selecteer Opslaan.

   Details van de nieuwe API-clientweergave.

   

6. Zorg ervoor dat u de klant-ID en het geheim naar een tekstdocument kopieert voor later gebruik. Het clientgeheim wordt niet meer weergegeven. Selecteer Sluiten.

7. De API-client wordt aangemaakt.

   

   • Bewerken Wijzig de alias, de rollen of de app-toegang van de client.
   • Clientgeheim opnieuw instellen: Genereer een nieuw klantgeheim. Om veiligheidsredenen raden we aan om de secret na regelmatige intervallen te resetten. Houd er rekening mee dat u alle externe applicaties moet bijwerken die gebruik maakten van de vorige geheimcode.
   • Verwijderen: Verwijder de API-client.

8. Geef de API-client-ID en het geheim door aan de ontwikkelaars van uw bedrijf, zodat zij het API-token kunnen genereren.