> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentwallex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Presentation de la reference API

> URL de base, authentification, pagination et contrat d'erreur pour l'API REST AgentWallex.

## URL de base

```
Sandbox:    https://api-sandbox.agentwallex.com/api/v1
Production: https://api.agentwallex.com/api/v1
```

<Note>
  Utilisez l'URL sandbox pour le developpement et les tests. Passez en production uniquement lorsque vous etes pret a effectuer des transactions avec des fonds reels.
</Note>

## Authentification

Toutes les requetes API doivent inclure l'un des en-tetes d'authentification suivants :

| Methode    | En-tete         | Exemple                               |
| ---------- | --------------- | ------------------------------------- |
| Cle API    | `X-API-Key`     | `X-API-Key: awx_your_api_key`         |
| JWT Bearer | `Authorization` | `Authorization: Bearer eyJhbGciOi...` |

```bash theme={null}
# API key authentication
curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "X-API-Key: awx_your_api_key"

# JWT authentication
curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "Authorization: Bearer eyJhbGciOi..."
```

Consultez [Authentification](/fr/introduction/authentication) pour les details complets sur l'obtention et la gestion des identifiants.

## Pagination

Tous les points de terminaison de liste prennent en charge la pagination avec les parametres de requete suivants :

| Parametre   | Par defaut | Maximum | Description                 |
| ----------- | ---------- | ------- | --------------------------- |
| `page_num`  | 1          | --      | Numero de page (indexe a 1) |
| `page_size` | 20         | 100     | Nombre d'elements par page  |

Format de reponse :

```json theme={null}
{
  "data": [],
  "total": 42,
  "has_more": true
}
```

## Contrat d'erreur

Toutes les erreurs suivent un format coherent :

```json theme={null}
{
  "code": "invalid_request",
  "type": "invalid_request_error",
  "message": "human readable error description"
}
```

### Types d'erreurs

| Type                    | Statut HTTP | Description                              |
| ----------------------- | ----------- | ---------------------------------------- |
| `invalid_request_error` | 400         | Corps de requete ou parametres invalides |
| `authentication_error`  | 401         | Identifiants manquants ou invalides      |
| `authorization_error`   | 403         | Permissions insuffisantes                |
| `not_found_error`       | 404         | La ressource n'existe pas                |
| `rate_limit_error`      | 429         | Limite de debit depassee                 |
| `internal_error`        | 500         | Erreur cote serveur                      |

Consultez [Gestion des erreurs](/fr/guides/error-handling) pour des conseils detailles sur la gestion des erreurs.

## Sections de l'API

<CardGroup cols={2}>
  <Card title="Agents" icon="robot" href="/fr/api-reference/agents-create">
    Creez et gerez les portefeuilles d'agents IA.
  </Card>

  <Card title="Transactions" icon="arrow-right-arrow-left" href="/fr/api-reference/transactions-create">
    Envoyez des paiements et interrogez l'historique des transactions.
  </Card>

  <Card title="Politiques" icon="shield-check" href="/fr/api-reference/policies">
    Configurez les limites de depenses et les controles d'acces.
  </Card>

  <Card title="Webhooks" icon="bell" href="/fr/api-reference/webhooks">
    Enregistrez et gerez les points de terminaison webhook.
  </Card>

  <Card title="x402 Pay" icon="credit-card" href="/fr/api-reference/x402-pay">
    Declenchez la negociation de micropaiement x402.
  </Card>

  <Card title="Sessions x402" icon="clock" href="/fr/api-reference/x402-sessions">
    Gerez les budgets de session x402.
  </Card>
</CardGroup>