SDK et outils

Tout part de la spécification OpenAPI, publiée avec cette documentation et mise à jour à chaque évolution de l'API :

• https://developers.eldowallet.fr/openapi.en.yaml (descriptions en anglais)
• https://developers.eldowallet.fr/openapi.fr.yaml (descriptions en français)

Node.js : client prêt à l'emploi avec api

npx api install https://developers.eldowallet.fr/openapi.en.yaml --identifier eldowallet

L'outil génère un SDK typé dans votre projet et affiche le nom du paquet à importer :

import eldowallet from '@api/eldowallet';

eldowallet.auth(process.env.ELDO_TOKEN);
const {data} = await eldowallet.getClients({page: 1, limit: 20});

Les noms de méthodes sont les identifiants d'opération affichés sur chaque page de la référence API.

TypeScript : types seuls

npx openapi-typescript https://developers.eldowallet.fr/openapi.en.yaml -o src/eldowallet.d.ts

Autres langages (PHP, Python, Java, C#…)

OpenAPI Generator produit un client dans plus de 50 langages :

PHP

npx @openapitools/openapi-generator-cli generate \
  -i https://developers.eldowallet.fr/openapi.en.yaml \
  -g php -o ./eldowallet-php --additional-properties=invokerPackage=EldoWallet

Python

npx @openapitools/openapi-generator-cli generate \
  -i https://developers.eldowallet.fr/openapi.en.yaml \
  -g python -o ./eldowallet-python --additional-properties=packageName=eldowallet

Java

npx @openapitools/openapi-generator-cli generate \
  -i https://developers.eldowallet.fr/openapi.en.yaml \
  -g java -o ./eldowallet-java

C#

npx @openapitools/openapi-generator-cli generate \
  -i https://developers.eldowallet.fr/openapi.en.yaml \
  -g csharp -o ./EldoWallet

Postman et Insomnia

Une collection prête à l'emploi : les 129 requêtes de l'API, rangées par domaine, déjà configurées sur l'environnement de test et l'authentification.

Télécharger la collection Postman

1. Dans Postman, cliquez sur Import et déposez le fichier téléchargé.
2. Ouvrez la collection eldo wallet API v2 (test), onglet Variables, et collez votre jeton d'API dans token. Pas encore de jeton ? Demandez un accès de test, il arrive par e-mail.
3. Envoyez n'importe quelle requête : l'URL de test et l'en-tête Authorization: Bearer sont déjà en place.

Insomnia, Bruno ou un autre outil : importez la spécification OpenAPI par son URL.

URL de la spécification

https://developers.eldowallet.fr/openapi.fr.yaml

Assistants IA

• /llms.txt : index de toute la documentation, au format llmstxt.org.
• /llms-full.txt : toute la documentation en un seul fichier texte.
• Toutes les pages sont en HTML statique : un assistant peut lire n'importe quelle URL de ce site.

Donnez l'une de ces URL à votre assistant de code (Claude, Copilot, Cursor…) pour qu'il écrive l'intégration à partir de la vraie spécification.