Authentication

Secure your API requests with authentication.

API Keys

API keys are the simplest way to authenticate with our APIs. Generate keys from your dashboard.

bash
curl -X GET https://api.perceptos.com/v1/status \
  -H "Authorization: Bearer sk_live_abc123xyz"

OAuth 2.0

For user-facing applications, use OAuth 2.0 for delegated access.

bash
Authorization Code Flow:
1. Redirect to: https://auth.perceptos.com/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI
2. Exchange code for token
3. Use token to access API

Security Best Practices

  • •Never commit API keys to version control
  • •Rotate keys regularly
  • •Use environment variables for secrets
  • •Restrict key permissions to minimum required scope