Authentication
Learn how to authenticate with Manu Documentation API
Authentication Methods
Manu Documentation supports multiple authentication methods to secure your documentation space. You choose the method that best fits your organization's security requirements and workflow.
Use API keys for programmatic access to the Manu Documentation API.
Generate Key
Go to your account settings and generate a new API key.
Store Securely
Store the API key securely in your environment variables.
Include in Requests
Include the API key in the Authorization header of your requests.
Use OAuth 2.0 for user-based authentication with third-party providers.
Use JSON Web Tokens for stateless authentication in distributed systems.
API Key Authentication
You authenticate API requests using Bearer token authentication with your API key. Include the key in the Authorization header for all API calls.
curl -X GET \
https://api.manudocs.com/v1/documents \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
const response = await fetch('https://api.manudocs.com/v1/documents', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.MANU_API_KEY}`,
'Content-Type': 'application/json'
}
});
const documents = await response.json();
console.log(documents);
import requests
headers = {
'Authorization': f'Bearer {os.environ["MANU_API_KEY"]}',
'Content-Type': 'application/json'
}
response = requests.get('https://api.manudocs.com/v1/documents', headers=headers)
documents = response.json()
print(documents)
OAuth Flow
For OAuth authentication, you redirect users to the authorization endpoint. After authorization, you receive an access token for API calls.
Redirect to Auth
Redirect users to https://api.manudocs.com/oauth/authorize with client ID and scope.
User Approves
User approves the authorization request.
Receive Token
Receive authorization code and exchange for access token.
Use Token
Use the access token in subsequent API requests.
Security Best Practices
You implement several security measures to protect your documentation space. Always use HTTPS for all API communications and never expose API keys in client-side code.
Troubleshooting
If you encounter authentication issues, check these common problems. Most authentication errors stem from incorrect API key usage or expired tokens.
| Issue | Cause | Solution |
|---|---|---|
| 401 Unauthorized | Invalid API key | Verify API key is correct and active |
| 403 Forbidden | Insufficient permissions | Check user roles and permissions |
| Token expired | JWT token expired | Refresh token or re-authenticate |
Rate Limits
Manu Documentation enforces rate limits to ensure fair usage. You monitor your API usage through the dashboard and upgrade plans for higher limits.
Rate Limit Changes
- Increased rate limits for enterprise plans
- Added detailed rate limit headers in responses
- Improved error messages for rate limit exceeded
Last updated 6 days ago