Authentication

The SelamAPI uses API keys and JWT tokens to authenticate requests. You can view and manage your API keys in the SelamGPT dashboard.

API Keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error. Most endpoints require only an API key, but some advanced features may require additional JWT authentication.

Including the API key

Include your API key in an Authorization HTTP header. Always use HTTPS in production.

1Authorization: Bearer sk-selam-your-api-key-here

Making authenticated requests

You can use your API key in REST API calls by passing it in the Authorization header:

1curl https://api.selamgpt.com/v1/chat/completions \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer sk-selam-your-api-key-here" \
4  -d '{
5    "model": "selam-plus",
6    "messages": [
7      {
8        "role": "user",
9        "content": "Hello!"
10      }
11    ]
12  }'

JWT Token Authentication

Some advanced features require JWT token authentication in addition to your API key. JWT tokens provide additional security and user context for specific operations.

Using JWT Tokens

Include your JWT token in the Authorization header alongside your API key:

1curl https://api.selamgpt.com/v1/endpoint \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer your-jwt-token" \
4  -H "X-API-Key: sk-selam-your-api-key-here" \
5  -d '{
6    "param": "value"
7  }'

Security Best Practices

Authentication Errors

Common authentication errors and how to resolve them:

1{
2  "error": {
3    "message": "Invalid API key provided.",
4    "type": "authentication_error",
5    "code": "invalid_api_key"
6  }
7}

1{
2  "error": {
3    "message": "No API key provided.",
4    "type": "authentication_error",
5    "code": "missing_api_key"
6  }
7}

1{
2  "error": {
3    "message": "Your account does not have access to this feature.",
4    "type": "authorization_error",
5    "code": "insufficient_permissions"
6  }
7}