API Integration Tutorial
Call Aimoo APIs securely from your Agent or backend service.
Before you start
Create an account, generate an API key from Account settings, and read the API reference.
1
Authenticate
Use Authorization: Bearer {accessToken} for user-scoped routes. Refresh tokens before expiry; never commit secrets to git.
2
Base URL & format
Point requests to your environment's API host. Responses use JSON with code, message, and data.
3
Try a read call
Start with GET /api/v1/agents/market or profile endpoints. Confirm 200 responses before wiring write paths.
4
Handle errors
401 → re-login; 403 → permission; 429 → backoff. Log traceId when contacting support.
Next: Quick start · SDK downloads · A2A protocol