De API-sleutels van je account beheren
Eigenaren, beheerders en managers hebben toegang tot het tabblad API-sleutels.
Ontdek hoe je toegang krijgt tot je API-sleutels voor je Klaviyo-account en hoe je deze kunt beheren.
Als je meer wilt weten over het maken of klonen van een privé-API-sleutel, lees dan Privé-API-sleutels maken.
Het verschil tussen openbare en privé-API-sleutels
Je openbare API-sleutel wordt ook wel je site-ID genoemd. Dit is een korte alfanumerieke waarde. Deze openbare sleutel is een unieke identificator voor je Klaviyo-account en er is er maar 1 per account. Je kunt je openbare API-sleutel opnemen in websitecode. Hiermee krijg je geen toestemming om privé-accountgegevens te lezen.
Met privé-API-sleutels kunnen applicaties gegevens in je Klaviyo-account lezen of wijzigen, zoals lijsten, volgens de machtigingen (scopes) die je selecteert. Behandel privé-API-sleutels als wachtwoorden: bewaar ze op een veilige plek en maak ze nooit openbaar. Een Klaviyo-account kan zoveel privé-API-sleutels genereren als nodig is.
Wat te doen als je API-sleutel is blootgesteld
Je openbare API-sleutel is bedoeld voor gebruik in openbare websitecode. Het laat iemand geen privé accountgegevens lezen, maar het kan worden gebruikt om gegevens in te dienen via client-API’s, zoals events en profielupdates.
Houd privé API-sleutels vertrouwelijk. Iemand met een privésleutel kan de bijbehorende machtigingen gebruiken om klantgegevens te bekijken of te bewerken.
Als een privé-API-sleutel is blootgesteld, verwijder je die onmiddellijk en maak je een nieuwe privé-API-sleutel aan. Werk elke applicatie die de blootgestelde sleutel gebruikte bij om de nieuwe sleutel te gebruiken. Geef de vervangende sleutel alleen de rechten die de applicatie nodig heeft en gebruik voor elke applicatie een andere privé-API-sleutel.
Je API-sleutels zoeken
Kopieer of download een privé-API-sleutel zodra je deze maakt, voordat je de bevestigingspagina verlaat. Je kunt de volledige sleutel later niet opnieuw bekijken. Bewaar het veilig, bijvoorbeeld in een kluis of wachtwoordmanager, en deel het alleen met partijen die je vertrouwt. Als je de sleutel niet hebt opgeslagen, maak dan een nieuwe sleutel aan of kloon de bestaande.
- Klik linksonder op je accountnaam.
- Klik op Instellingen.
- Selecteer het tabblad API-sleutels .
- Bekijk je openbare API-sleutel (site-ID).
- Controleer onder Privé-API-sleutels de namen en toegangsniveaus van de sleutels. Je kunt een sleutel herkennen aan de laatste 4 tekens, maar je kunt de volledige sleutel hier niet bekijken of kopiëren.
Als een sleutel niet op het tabblad Actief staat, controleer dan Inactive of Uitgeschakeld als die tabbladen worden weergegeven.
Privé-API-sleutel klonen
Wanneer je bestaande privé-API-sleutels kloont, zal de gekloonde sleutel:
- een geheel andere sleutel zijn dan het origineel.
- Gebruik dezelfde naam als het origineel.
- Heb dezelfde scopes als het origineel, behalve verouderde scopes die niet langer worden ondersteund.
Bij klonen blijft de oorspronkelijke sleutel staan. Kopieer of download de gekloonde sleutel en sla deze veilig op. Wil je deze in een applicatie gebruiken, werk dan de instellingen van die applicatie bij met de nieuwe sleutel. Verwijder de oorspronkelijke sleutel zodra je deze niet meer nodig hebt.
Privé-API-sleutel verwijderen
Het verwijderen van een privé API-sleutel kan niet ongedaan worden gemaakt. API-verzoeken die het gebruiken, werken niet meer. Als je een sleutel vervangt die niet is blootgesteld, werk dan de applicaties die deze gebruiken bij en test ze voordat je de sleutel verwijdert. Als de sleutel is blootgesteld, verwijder je deze onmiddellijk.
- Open het tabblad API-sleutels met de stappen hierboven. Zoek onder Privé API-sleutels de sleutel die je wilt verwijderen.
- Open het 3-puntenmenu naast de sleutel en selecteer Verwijderen.
- Klik in het bevestigingsvenster op Verwijderen.
Extra hulpbronnen
- How to create or clone a private API key
Learn how to create a private API key, which is a unique identifier used for API calls, as well as define a scope.
- Understanding how information is exchanged between Klaviyo and apps
Learn about how information syncs between Klaviyo and your third-party apps via an application programming interface (API). Most data exchanged via a Klaviyo integration is one-way: data is pulled into your Klaviyo account so you can leverage a broad scope of your customer's data.
- Klaviyo's API reference guide