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