V1 API

Stable Released: 2024-01-15

Base URL

https://api.chamberlink.com/v1

V1 API Documentation

The stable version of the Chamber Link API with core functionality.

Authentication

All API requests must be authenticated using OAuth 2.0 with the Client Credentials grant type. You'll need to obtain an access token by making a request to the /auth/token endpoint.

Example Request

curl -X POST https://api.chamberlink.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "your_client_id",
    "client_secret": "your_client_secret",
    "grant_type": "client_credentials"
  }'

Example Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Making API Requests

Once you have an access token, include it in the Authorization header of your API requests:

curl -X GET https://api.chamberlink.com/v1/chambers \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Authentication

Endpoints for authentication and authorization.

POST

/auth/token

Generate an access token

Parameters

Name Type Required Description
client_id string Yes Your API client ID
client_secret string Yes Your API client secret
grant_type string Yes The grant type (client_credentials)

Example Request

curl -X POST https://api.chamberlink.com/v1/auth/token \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Responses

200 Success
{"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "token_type": "Bearer", "expires_in": 3600}
401 Unauthorized
{"error": "invalid_client", "error_description": "Client authentication failed"}

Chambers

Endpoints for managing chambers.

GET

/chambers

List all chambers

Parameters

Name Type Required Description
page integer No Page number (default: 1)
per_page integer No Items per page (default: 20, max: 100)

Example Request

curl -X GET https://api.chamberlink.com/v1/chambers \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Responses

200 Success
{"data": [...], "meta": {"current_page": 1, "total": 50, "per_page": 20}}
GET

/chambers/{id}

Get a specific chamber

Parameters

Name Type Required Description
id string Yes Chamber ID

Example Request

curl -X GET https://api.chamberlink.com/v1/chambers/{id} \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Responses

200 Success
{"id": "123", "name": "Example Chamber", ...}
404 Not Found
{"error": "Chamber not found"}

Members

Endpoints for managing chamber members.

GET

/chambers/{chamber_id}/members

List members of a chamber

Parameters

Name Type Required Description
chamber_id string Yes Chamber ID
page integer No Page number (default: 1)
per_page integer No Items per page (default: 20, max: 100)

Example Request

curl -X GET https://api.chamberlink.com/v1/chambers/{chamber_id}/members \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Responses

200 Success
{"data": [...], "meta": {"current_page": 1, "total": 50, "per_page": 20}}