Core ConceptsAuthentication
Core Concepts

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.

Rotate API keys regularly for enhanced security.

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"

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.

Never commit API keys to version control systems.

Troubleshooting

If you encounter authentication issues, check these common problems. Most authentication errors stem from incorrect API key usage or expired tokens.

IssueCauseSolution
401 UnauthorizedInvalid API keyVerify API key is correct and active
403 ForbiddenInsufficient permissionsCheck user roles and permissions
Token expiredJWT token expiredRefresh 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.

2024-10-01Rate Limit Updates
improvementsecurity

Rate Limit Changes

  • Increased rate limits for enterprise plans
  • Added detailed rate limit headers in responses
  • Improved error messages for rate limit exceeded
Was this page helpful?
Built with Documentation.AI

Last updated 6 days ago