Presentation de la reference API

URL de base

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

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.

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...`

# 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 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 :

{
  "data": [],
  "total": 42,
  "has_more": true
}

Contrat d’erreur

Toutes les erreurs suivent un format coherent :

{
  "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 pour des conseils detailles sur la gestion des erreurs.

Sections de l’API

Agents

Creez et gerez les portefeuilles d’agents IA.

Transactions

Envoyez des paiements et interrogez l’historique des transactions.

Politiques

Configurez les limites de depenses et les controles d’acces.

Webhooks

Enregistrez et gerez les points de terminaison webhook.

x402 Pay

Declenchez la negociation de micropaiement x402.

Sessions x402

Gerez les budgets de session x402.

​URL de base

​Authentification

​Pagination

​Contrat d’erreur

​Types d’erreurs

​Sections de l’API

Agents

Transactions

Politiques

Webhooks

x402 Pay

Sessions x402

URL de base

Authentification

Pagination

Contrat d’erreur

Types d’erreurs

Sections de l’API