Welcome to the Authentication API documentation for our mobile SDK. This guide explains how to securely authenticate users using our platform's APIs.

Key Authentication Flow 🔄

  1. Initialize SDK
    Configure your app with the init() method, providing your API key and secret:

    SDK.init(apiKey: "YOUR_API_KEY", secret: "YOUR_SECRET")
    
    SDK Initialization
  2. Request Token
    Call the /auth/token endpoint to obtain a session token:

    GET /auth/token?grant_type=client_credentials
    

    📌 Include this in your app's login flow to verify user identity.

  3. Token Response
    The server returns a JSON payload with the token and expiration time:

    {
      "access_token": "abc123xyz",
      "expires_in": 3600,
      "token_type": "Bearer"
    }
    
    Token Response

Best Practices 🔒

  • Always use HTTPS for secure communication
  • Store tokens in encrypted storage (e.g., Keychain on iOS)
  • Implement refresh tokens for long-term sessions

For detailed implementation examples, see our Mobile SDK Quick Start Guide.
Need help troubleshooting? Check our Authentication FAQ.

💡 Authentication is the first step to accessing protected resources. Ensure your implementation aligns with our security policies.