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}}