In de integratie Full-featured API genereer je de API-sleutels waarmee programmatische toegang tot je Personyze-account wordt geauthenticeerd — gebruikers, catalogi, interacties, placeholders en rapporten lezen en schrijven.
In het panel: Instellingen › Integraties › Full-featured API.
Een sleutel genereren
- Open Instellingen › Integraties en klik op Beheren op de kaart Full-featured API.
- Genereer een nieuwe sleutel en kopieer die. Sla hem meteen op — de waarde van een bestaande sleutel is later op geen enkele manier terug te halen.
- Geef elke integratie een eigen sleutel, zodat je er een kunt intrekken zonder de andere te breken.
Een sleutel verwijderen werkt meteen: alles wat hem nog gebruikt, krijgt vanaf dan 401. Genereer de vervanger en rol die uit voordat je de oude intrekt.
Zapier-wachtwoorden en sleutels voor de Full-featured API zijn dezelfde set sleutels. Een sleutel die op een van beide kaarten is gegenereerd, verschijnt op allebei, en elke sleutel authenticeert elk endpoint.
Gebruiken
De authenticatie is HTTP Basic via HTTPS — gebruikersnaam api, wachtwoord je sleutel:
curl 'https://api:YOUR_API_KEY@app.personyze.com/rest/account'Dat endpoint geeft {"id": …} terug en raakt niets aan, dus het is de goedkoopste manier om te controleren of een sleutel werkt.
Volledige naslag
De volledige API-documentatie staat in de wiki voor developers:
- Overzicht van de REST API — vorm van een verzoek, HTTP-werkwoorden, responscodes, conventies.
- API-sleutels — de sleutel meesturen, testen, soorten sleutels, en hem veilig houden.
- Padparameters van verzoeken — de
where/order_by/limit/columns-syntaxis die elk object deelt. - Fouten, limieten en opnieuw proberen — statuscodes, de limiet van 1000 rijen, de indexeringsregels, en wat veilig opnieuw kan worden geprobeerd.
- Een integratie bouwen — welk endpoint wat doet, en het gedrag dat mensen verrast.
De objecten
- Gebruikers — users, users_columns, user_lists, user_list_users, user_interests, do
- Catalogus — products, articles, products_interactions, products_stats
- Statistieken — summary_actions, sessions_archive, events, forms
- Configuratie — placeholders, actions, conditions, containers_grab_variable
Voor personalisatie aan de serverkant — Personyze vragen wat een bezoeker moet zien en dat zelf weergeven — zie personalisatie en A/B-testen aan de serverkant.
Gerelateerd
- Zapier-integratie — de route zonder code naar dezelfde API.