Collection Postman
Chaque contrat est fourni avec une collection Postman préconfigurée avec des URL sandbox et des corps de requête d'exemple. Importez la collection, renseignez vos identifiants et vous pouvez appeler chaque point de terminaison sans écrire de code.
Collections par contrat
| Contrat | Collection | Notes |
|---|---|---|
| Authentification | Télécharger | Téléchargez le fichier ci-dessous, importez-le dans Postman et remplacez les valeurs des paramètres "service_account," "tenant_id," et "secret_key" pour tester la requête. |
| Web & SDK | Télécharger | Inclut la création de processus, GET processus, GET preuves et GET PDF. |
| API | Télécharger | Inclut la création de processus (POST) et GET processus. |
Configuration
- Téléchargez la collection correspondant au contrat que vous intégrez.
- Importez-la dans Postman :
File > Import > Upload Files. - Configurez les identifiants selon la collection :
Authentification — ouvrez la collection, accédez à l'onglet Variables et renseignez :
| Variable | Valeur |
|---|---|
service_account | Votre nom de compte de service. |
tenant_id | Votre ID de tenant. |
secret_key | Votre clé privée (format PEM). |
base_path | Hôte du point de terminaison du jeton. Par défaut UAT (https://identityhomolog.acesso.io) ; changez en https://identity.acesso.io pour la production. |
Web & SDK — ouvrez chaque requête et remplacez la valeur Authorization: Bearer par votre propre jeton d'accès.
API — ouvrez chaque requête et remplacez les valeurs des en-têtes Authorization: Bearer et APIKEY par vos propres identifiants.
- Exécutez la requête d'authentification — le script de pré-requête construit automatiquement l'assertion JWT et la stocke dans
{{jwt_token}}.
Scripts de pré-requête
Seule la collection Authentification inclut un script de pré-requête. Il :
- Lit
service_account,tenant_id,secret_keyetbase_pathdepuis les variables de la collection. - Construit et signe l'assertion JWT (RS256) en utilisant la bibliothèque KJUR embarquée.
- Sauvegarde le jeton signé dans
{{jwt_token}}, qui est automatiquement injecté dans le corps de la requête.
Les collections Web & SDK et API n'ont pas de scripts de pré-requête — les identifiants sont définis directement dans les en-têtes des requêtes.
Étapes suivantes
- Authentification — générez les identifiants dont la collection a besoin.
- Vue d'ensemble Web & SDK — contexte pour la collection Web & SDK.
- Vue d'ensemble API — contexte pour la collection API.