Webhooks: aanmaken van profielen
Als je in real-time op de hoogte gebracht wil worden wanneer er een nieuw profiel of subprofiel in een van je database aangemaakt wordt, kun je hiervoor een Webhook instellen. Voor elk nieuw profiel sturen we via HTTP of HTTPS een POST bericht naar jouw server met daarin alle relevante informatie over het zojuist aangemaakte profiel.
Variabelen
Bij elke POST-oproep worden de variabelen in de onderstaande tabel verzonden. De POST-gegevens worden verzonden met het inhoudstype application/x-www-form-urlencoded.
Associative arrays zoals "parameters" en "fields" worden per key-valuepaar verstuurd, bijvoorbeeld als parameters[key]=value. Arrays zoals "interests" worden worden per item verstuurd als interests[]=xyz.
Voor elk profiel worden de volgende waarden meegegeven:
| Variabelen | Omschrijving |
|---|---|
| type | Type actie dat de Webhook heeft getriggerd ('create') |
| parameters | Parameters voor het uitvoeren van de actie |
| timestamp | Tijdstempel van het aanmaken van het profiel (in YYYY-MM-DD HH:MM:SS format) |
| time | Unix tijd van het updaten van het profiel |
| profile | Unieke identifier van het profiel dat werd aangemaakt |
| database | Unieke identifier van de database van het profiel |
| created | Tijd van aanmaken (in YYYY-MM-DD HH:MM:SS format) |
| modified | Tijd van laatste aanpassing (in YYYY-MM-DD HH:MM:SS format) |
| fields | Huidige velden van het profiel |
| interests | Huidige interesses van het profiel |
Voor subprofielen zijn dit de volgende variabelen:
| Variabele | Omschrijving |
|---|---|
| type | Type actie dat de Webhook heeft getriggerd ('create') |
| parameters | Parameters voor het uitvoeren van de actie |
| timestamp | Tijdstempel van het aanmaken van het profiel (in YYYY-MM-DD HH:MM:SS format) |
| time | Unix tijd van het updaten van het profiel |
| profile | Unieke identifier van het profiel van het subprofiel |
| subprofile | Unieke identifier van het subprofiel dat werd aangemaakt |
| database | Unieke identifier van de database van het subprofiel |
| collection | Unieke identifier van de collectie van het subprofiel |
| created | Tijdstempel van aanmaken (in YYYY-MM-DD HH:MM:SS format) |
| modified | Tijdstempel van laatste aanpassing (in YYYY-MM-DD HH:MM:SS format) |
| fields | Huidige velden van het subprofiel |
Voorbeeld
Een gedecodeerde JSON response voor een profiel ziet er bijvoorbeeld zo uit:
{
"type": "create",
"profile": 123,
"parameters": {
"name": "Johny",
"mail": "johny@example.com",
"blue": 1,
"red": 0
},
"timestamp": "1979-02-12 12:49:23",
"id": 123,
"database": 1,
"fields": {
"name": "Johny",
"mail": "johny@example.com"
},
"interests": {
"blue": 1,
"red": 0
},
"created": "1979-02-12 12:49:23",
"modified": "1979-02-12 12:49:23"
}Een voorbeeld van een subprofiel ziet er zo uit:
{
"type": "create",
"subprofile": 123,
"parameters": {
"name": "Johny",
"mail": "johny@example.com",
},
"timestamp": "1979-02-12 12:49:23",
"id": 12,
"database": 1,
"collection": 2,
"profile": 123,
"fields": {
"name": "Johny",
"mail": "johny@example.com"
},
"created": "1979-02-12 12:49:23",
"modified": "1979-02-12 12:49:23"
}