Oveit API documentation

Welcome to the Oveit API documentation website. You can use our API to access organizer-specific Oveit functions, such as fetching event information, checking in ticket codes, and more.

Introduction

All API methods will be called via POST requests to https://l.oveit.com/api/[endpoint].

The server will always reply with a 200 OK HTTP status code, even when there was an API error. Any kind of HTTP error code (4xx or 5xx) therefore represents an HTTP communication error, and not a problem with the parameters you sent for a particular API call.

All API methods will respond with a JSON result. In case an error occurs, the response will contain an error key:

{
    "error": "This ticket does not exist"
}

Authentication

Most API methods expect a valid authorization token parameter. To obtain an access token, send a POST request to the seller/login endpoint with your organizer credentials. Use the resulting access token as a parameter for all subsequent API calls.

HTTP request

POST https://l.oveit.com/api/seller/login

Request parameters

Parameter Description
email Your organizer account email address
password Your password

Response example

{
    "token": "1065c69ad55314af",
    "expires_at": "2015-01-07 18:31:57",
    "expires_in": 7200 // seconds
}

Note

Access tokens expire in two hours, but each API call made using a particular token resets this timer. This means each token expires after two hours since the last API call.

Password recovery

Sends an email with password reset instructions to the specified email address.

HTTP request

POST https://l.oveit.com/api/seller/recover_password

Request parameters

Parameter Description
email The email address to send the password reset instructions to

Response

{
    "ok": true
}