Documentation
Everything you need to integrate, use, and get the most out of MOMO LENS.
API Reference
Complete interactive API documentation for MOMO LENS. Explore all endpoints, request/response schemas, and test API calls directly from your browser.
Authentication
Use JWT tokens for user sessions or API keys for third-party integrations
Base URL
https://momolens-production.up.railway.app/api/v1
Version
API v1.0.0
Authentication Methods
Option 1: JWT Tokens (User Sessions)
For mobile apps and web applications with user sessions. Tokens expire after 24 hours.
Step 1: Login
POST /api/v1/auth/login
Content-Type: application/json
{
"email": "your-email@example.com",
"password": "your-password"
}
Response:
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"refresh_token": "...",
"expires_in": 3600
}Step 2: Use Token
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Option 2: API Keys (Third-Party Integrations)
Full GuideFor server-to-server integrations, third-party applications, and automated systems. Long-lived keys that don't expire unless revoked.
Step 1: Create API Key (one-time, requires JWT)
POST /api/v1/api-keys
Authorization: Bearer <jwt-token>
Content-Type: application/json
{
"name": "Production Integration Key",
"expiresAt": "2025-12-31T23:59:59Z",
"allowedOrigins": ["https://your-app.com"]
}
Response:
{
"key": "ml_live_abc12345def67890...", // Store this immediately!
"keyPrefix": "ml_live_abc12345",
"status": "ACTIVE"
}Step 2: Use API Key
X-API-Key: ml_live_abc12345def67890... # OR Authorization: Bearer ml_live_abc12345def67890...
Note: The full API key is only shown once during creation. Store it securely - you won't be able to retrieve it again!
Interactive API Documentation
Loading API documentation...