Bronnen voor developers

Personyze biedt een REST API om je account programmatisch te beheren, een templatetaal om de HTML van acties te schrijven, en een set SDK’s voor integratie met native mobiele apps en tagmanagers. Deze pagina is het startpunt — korte overzichten plus links naar de volledige naslagdocumentatie.

REST API

Met de REST API van Personyze kunnen applicaties van derden data in je account lezen en wijzigen: gebruikers en gebruikerslijsten beheren, met de product- en artikelcatalogus werken, placeholders en acties bedienen, live bewerkingen op online gebruikers uitvoeren, dagelijkse rapportagesamenvattingen opvragen, en meer. Hij gebruikt standaard-HTTP, accepteert en geeft JSON terug, en ondersteunt de vier standaardwerkwoorden (GET, POST, PUT, DELETE).

Snel voorbeeld

Haal de gebruiker op met interne ID 42:

curl 'https://api:YOUR_API_KEY@app.personyze.com/rest/users/where/internal_id=42'

De algemene vorm van elk verzoek:

https://api:<API_KEY>@app.personyze.com/rest/<object>[/<modifier>/<value>...]

Volledige naslag van de REST API (4 artikelen)

📖 Overzicht & snel aan de slagVorm van een verzoek, HTTP-methoden, responscodes, conventies zoals id vs internal_id. Lezen →

🔑 AuthenticatieJe API-sleutel ophalen, die via een header of URL meesturen, foutcodes, patronen voor meerdere accounts. curl-, Python- en JS-voorbeelden. Lezen →

🧩 PadparametersDe where / columns / order_by / limit -syntaxis met alle operatoren, combinaties met AND/OR, en regels voor geïndexeerde kolommen. Lezen →

📚 Naslag van objectenPagina’s per object voor alle 18 endpoints — users, products, articles, actions, placeholders, interactions, events, sessions, summaries. Lezen →

Templatetaal

Personyze-acties (banners, pop-ups, aanbevelingswidgets, e-mails) worden geschreven in een templatetaal die grotendeels gewone HTML en CSS is, met directives voor bewerkbare parameters, lussen over Personyze-tabellen (producten, artikelen), voorwaarden, en speciale classnamen die van gewone elementen widgets maken die Personyze herkent.

📝 Templatetaal — naslag voor de HTML van actiesVolledige naslag van de syntaxis: ${args} -variabelen, gebruikers- & sessievariabelen, functies, ${foreach} -lussen over tabellen, voorwaarden, speciale $-classes met voorvoegsel ($responsive, $btn, $popup, $cform, enz.), formulierafhandeling, en de ${menu} -directives die de visuele editor opbouwen. Plus de GitHub-bibliotheek met 12 voorbeeldtemplates die klaar zijn voor gebruik. Lezen →

SDK’s & tools op GitHub

De REST API en de templatetaal staan nu volledig in de wiki, maar alle opensourcecode van Personyze blijft op GitHub, op github.com/personyze:

Native mobiele SDK’s

📱 Android SDK (Java)Volledige tracking en personalisatie van Personyze voor Android-apps. Repo → · Demo-app →

🍎 iOS SDK (Swift)Native iOS-integratie met dezelfde functies als de Android SDK. Repo → · Demo-app →

Beide SDK’s zijn gepubliceerd onder de MIT-licentie. De demo-apps zijn uitvoerbare voorbeelden die de volledige flow van installatie tot personalisatie laten zien. Voor een begeleide uitleg, zie de integratiehandleiding voor productaanbevelingen in mobiele apps.

Webtools

🏷 Template voor Google Tag ManagerDe trackingcode van Personyze, verpakt als importeerbare GTM-template. Zet die in je container in plaats van het snippet met de hand te coderen. Repo →

📑 Bron van de templatetaalDe bron van de naslag van de templatetaal (hierboven) plus 12 volledig geannoteerde voorbeeldtemplates: pop-ups, formulieren, timers, aanbevelingen, e-mails, social proof. Repo →

Combineer de GTM-template met de installatiehandleiding voor Google Tag Manager voor de volledige integratie.

Installatie per type site — tracking, feeds & integraties — kies je startpunt op basis van het type site.
Tracking van productinteractie-events — events om op webpagina’s af te vuren.
Product-/contentfeed instellen — de catalogkant van API-integraties.
Handleiding voor de JavaScript-actie — om eigen Personyze-acties in code te schrijven.