Aller au contenu principal

Faire ses premiers appels

Obtenez auprès de votre équipe une adresse de participant-api, le code participant, un environnement de recette et, en mode OIDC, un jeton approprié. Le portail peut être consulté sans démarrer le cœur ; les appels exigent un cœur disponible.

1. Préparer l’adresse et les accès​

Les commandes suivantes utilisent un shell compatible Bash. Remplacez les valeurs par celles de votre environnement. Le jeton reste une variable de session ; ne le placez pas dans un fichier partagé.

export CORE_API_URL='http://localhost:8080'
export PARTICIPANT_CODE='<code participant configuré>'

En mode OIDC, fournissez ACCESS_TOKEN dans votre session. Consultez le guide des accès pour le royaume et les rôles. En mode local OFF seulement, omettez l’en-tête Authorization.

2. Lire les transferts​

curl --fail-with-body \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  "$CORE_API_URL/api/v1/$PARTICIPANT_CODE/transfers?page=0&size=20"

La réponse est une page contenant notamment items, page, size, total et totalPages. Cette lecture ne crée aucune opération financière. Une liste vide est possible.

3. Préparer un transfert​

Choisissez un alias de recette remis par votre équipe :

curl --fail-with-body -i \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"alias":"<alias de recette>"}' \
  "$CORE_API_URL/api/v1/$PARTICIPANT_CODE/transfer-initiations"

La réponse 201 contient l’initiation et son endToEndId ; Location donne sa consultation. Ce premier appel réalise une recherche et ne transfère pas les fonds. Attendez une recherche aboutie, présentez le payé au client, puis suivez le guide transferts pour confirmer.

Essayer dans Scalar​

Ouvrez la référence API, sélectionnez le serveur correspondant à votre environnement et renseignez les paramètres de chemin. L’adresse par défaut est celle du cœur local. Les appels du navigateur restent soumis à CORS, au certificat TLS et aux autorisations de la cible. Un refus CORS ne prouve pas un échec métier ; utilisez votre client HTTP ou Postman si l’origine du portail n’est pas autorisée.