POST /visit/events
POST/visit/events
This endpoint can be used to post data for a given visitor, such as conversion events, page view events etc.
An incoming request is rejected if the source is identified as bot or spider, according to user-agent filtering rules from IAB/ABC. Kameleoon is using single-pass method. This means nothing specific is to be done in the case request is sent from a web browser using a standard library (XHR); but in other cases the user should set a custom value to the User-Agent request header, to overwrite the default value set by the library.
Request
Query Parameters
Id of the Kameleoon project
Visitor code (Kameleoon unique id for a visitor). Note: if the parameter "visitorCode" is provided here, then it is assumed as the common value for all events in the body (bulk posting of several events restricted to the same visitor). On the contrary, if you would like to bulk post several events across several different visitors, then you must provide the parameter "visitorCode" with every event in the body
Set to true if you provide the body content in JSON format, else URL query format is assumed. See body schema
false
- */*
Body
required
Events to save. Body size limited to 10 MB
string
Responses
- 204
- 400
- 401
- 403
- 413
- 429
- 500
Request is allowed, URL query was processed successfully, request body will be processed asynchronously, no content is returned in this response
Malformed request syntax
Failed authentication (missing token when required, bad token - malformed, expired, invalid signature)
Forbidden user-agent or access denied to restricted resource
Body too large
Rate limited
Unexpected internal error