Cles API

​

Presentation

​

Creer des cles API

​

Via le tableau de bord

1. Connectez-vous au tableau de bord AgentWallex.
2. Naviguez vers Parametres > Cles API.
3. Cliquez sur Creer une cle API.
4. Donnez a la cle un nom descriptif (par ex., production-backend, staging-ci).
5. Copiez et stockez la cle en securite — elle n’est affichee qu’une seule fois.

​

Via l’API

curl -X POST https://api.agentwallex.com/api/v1/api-keys \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Content-Type: application/json" \
  -d '{"name": "production-backend"}'

​

Lister les cles API

curl -X GET https://api.agentwallex.com/api/v1/api-keys \
  -H "Authorization: Bearer eyJhbGciOi..."

{
  "data": [
    {
      "id": "key_abc123",
      "name": "production-backend",
      "prefix": "awx_...x4f2",
      "created_at": "2025-06-01T10:00:00Z",
      "last_used_at": "2025-06-15T14:30:00Z"
    }
  ]
}

​

Rotation des cles API

curl -X DELETE https://api.agentwallex.com/api/v1/api-keys/key_abc123 \
  -H "Authorization: Bearer eyJhbGciOi..."

​

Limites de debit

{
  "code": "rate_limit_exceeded",
  "type": "rate_limit_error",
  "message": "Rate limit exceeded. Retry after 30 seconds."
}

​

Bonnes pratiques

• Une cle par environnement — Utilisez des cles separees pour le developpement, le staging et la production.
• Nommez les cles de maniere descriptive — Incluez l’environnement et le nom du service (par ex., prod-payment-service).
• Surveillez l’utilisation — Verifiez last_used_at pour identifier les cles inutilisees qui devraient etre supprimees.
• Ne partagez jamais les cles — Chaque membre de l’equipe ou service devrait avoir sa propre cle.
• Utilisez un gestionnaire de secrets — Stockez les cles dans AWS Secrets Manager, HashiCorp Vault ou des outils similaires plutot que dans des fichiers .env sur disque.