Please check our API Overview before continuing.
User endpoint base is user/ so for version 1 of our API you will use:
https://api.vtcdn.net/v1/user/
Return user information [GET]
GET /{email}
Return example: { "email: "[email protected]", "isSubscribed": true, "gender": "male", "city" : "Paris" }
Add new user [POST]
Create a new user, if the email does not exists.
POST /
Request example: { "email: "[email protected]", "isSubscribed": true, "gender": "male" }
Update user attributes [PUT]
Modify user attributes. Make sure you submit valid data for the attributes, otherwise they will be ignored.
PUT /{email}
Request example: { "isSubscribed": true, "gender": "male" }
Responses examples:
Response (HTTP status code: 200)
{
"results": {
"message": "Successfully added new user.",
"email": "[email protected]"
}
}
Response (HTTP status code: 404)
{
"errors": [
{
"message": "User not found",
"description": "This email does not exist in our database."
}
]
}
Response (HTTP status code: 400)
{
"errors": [
{
"message": Invalid data format/type",
"description": "Error validating user attributes",
}
]
}