Passer au contenu principal

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 :
MethodeEn-teteExemple
Cle APIX-API-KeyX-API-Key: awx_your_api_key
JWT BearerAuthorizationAuthorization: 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 :
ParametrePar defautMaximumDescription
page_num1Numero de page (indexe a 1)
page_size20100Nombre 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

TypeStatut HTTPDescription
invalid_request_error400Corps de requete ou parametres invalides
authentication_error401Identifiants manquants ou invalides
authorization_error403Permissions insuffisantes
not_found_error404La ressource n’existe pas
rate_limit_error429Limite de debit depassee
internal_error500Erreur 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.