Authentication
Every request needs an API token. Place2Book issues tokens. A token belongs to one API user and can reach the event makers that user has been granted.
Request headers
| Header | Value |
|---|---|
X-PLACE2BOOK-API-TOKEN |
Your API token. |
Accept |
application/vnd.place2book.v1+json |
Content-Type |
application/json (only for requests with a body) |
curl https://api.place2book.com/event_makers/1234567/events \
-H "X-PLACE2BOOK-API-TOKEN: $PLACE2BOOK_API_TOKEN" \
-H "Accept: application/vnd.place2book.v1+json"
Getting a token
To get a token, write to api@place2book.com and tell us which event makers the integration needs access to.
Keep your token secret The token has the same rights as the API user. Keep it on your server, never in browser or app code, and ask us to rotate it if it has been exposed.
Failed authentication
A missing or unknown token, or a token whose API user has been deactivated, returns 401 Unauthorized:
Response401 Unauthorized
{
"message": "API session not found"
}A valid token used with an event maker it does not have access to returns 404 Not Found, as if the event maker did not exist.