API Documentation

Click here to access the web documentation of the API.

API Authentication

Download Postman Collection

Click here to download the API collection (swagger.json).

To access the protected API endpoints, follow the authentication flow below:

1. Generate an Access Token

You must make a request to the /authorization endpoint to generate the authentication token. This token will be used to validate your future requests.

Endpoint: POST /authorization

Expected Response:

        {
        "token": "your_token_here"
        }

2. Use the Token in Request Headers

After obtaining the access token, include it in the request headers to the protected endpoints:

Header Key: Authorization
Value Format: Bearer <your_token_here>

Header Example:

Authorization: Bearer your_token_here

3. Token Validation

The API will verify the token sent. If the token is invalid, expired, or missing, the request will be rejected with HTTP status code 403 Forbidden.

4. Example of a Protected Request

        curl -X GET "https://oakberry.com/example_endpoint"         -H "Authorization: Bearer your_token_here"

Make sure to keep the token secure and renew it as needed.