Introduction

    API Endpoint

        https://api.barlijst.net/
                

De barlijst API allows you to communicate with barlijst.net through REST.

To use the API, you need to generate an API token in your account and include it as a Bearer header in your request.

POST Request webtoken

# Here is a curl example
curl -X POST \
 -H "Content-Type: application/json" \
 -H "Authorization: Basic [base64_encoded_string]" \
 -d '
 {
    "test": "blah"
 }
 ' \
 "https://api.barlijst.net/token"
                

Request a access token with basic auth:
https://api.barlijst.net/token

Result example :

{
    "access_token": "your.personal.token",
    "expires_at": 1739820479
}
                

REQUEST ATTRIBUTES

GET Test API

# Here is a curl example
curl -X GET \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer [your JSON web token]" \
 "https://api.barlijst.net/test"
                

You can test your API token with this endpoint:
https://api.barlijst.net/test

Result example :

{
    "status": "success"
}
                

GET List all groups

# Here is a curl example
curl -X GET \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer [your JSON web token]" \
 "https://api.barlijst.net/groups"
                

List all groups available in the barlijst
https://api.barlijst.net/groups

Result example :

[
    {
        "identifier": "uuid",
        "name": "example"
    }
]
                

Response codes

The barlijst API uses the following response codes: