Outils pour utilisateurs

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
guide_de_migration_shootid_vers_id360 [2025/04/10 14:24] – [Étape 1 – Authentification] adminguide_de_migration_shootid_vers_id360 [2025/10/22 14:43] (Version actuelle) – [⚠️ Attention : ne pas appeler le rapport immédiatement] admin
Ligne 1: Ligne 1:
 +[[:guide_de_migration_shootid_vers_id360|Français]] | [[:en:guide_de_migration_shootid_vers_id360|English]]
 +----
 +
 ====== Guide de migration ShootID vers ID360 ====== ====== Guide de migration ShootID vers ID360 ======
  
Ligne 22: Ligne 25:
 { {
   "username": "string",   "username": "string",
-  "password": "string"+  "password": "string"
-  "token": "string" // seulement pour comptes admin avec 2FA+
 } }
     </code>     </code>
Ligne 45: Ligne 47:
   * **Erreur en cas d’expiration** : HTTP 401 Unauthorized   * **Erreur en cas d’expiration** : HTTP 401 Unauthorized
  
-**🔄 Pour prolonger la validité du token** (sans générer un nouveau token) : +**🔄 Pour prolonger la validité du token (sans générer un nouveau token) :** 
-  <code>+ 
 +<code http>
 GET /api/1.0.0/user/whoami GET /api/1.0.0/user/whoami
 Authorization: Token 0123456789abcdef01234567 Authorization: Token 0123456789abcdef01234567
-  </code>+</code>
  
   * **Fréquence recommandée** : toutes les 13 minutes   * **Fréquence recommandée** : toutes les 13 minutes
Ligne 62: Ligne 65:
 | Endpoint                | N/A (inclus dans chaque appel)               | POST /user/login/                                                   | | Endpoint                | N/A (inclus dans chaque appel)               | POST /user/login/                                                   |
 | Format d’authentification | Authorization: Basic ...                   | Authorization: Token <jeton>                                        | | Format d’authentification | Authorization: Basic ...                   | Authorization: Token <jeton>                                        |
-| Validité du token       | Long terme (pas d’expiration)               | 15 min, renouvelée automatiquement sauf /login/                    |+| Validité du token       | Long terme (pas d’expiration)               expiré au delà de 15 min d'inactivité                    |
 | Prolongation du token   | N/A                                          | GET /user/whoami recommandé toutes les 13 min                       | | Prolongation du token   | N/A                                          | GET /user/whoami recommandé toutes les 13 min                       |
  
Ligne 84: Ligne 87:
 ==== 🔸 ID360 ==== ==== 🔸 ID360 ====
   * **Méthode** : `POST`   * **Méthode** : `POST`
-  * **URL PROD** : `https://id360docaposte.com/api/1.0.0/process/{id}/enrollment`   +  * **URL PROD** : `https://id360docaposte.com/api/1.0.0/process/{UUID}/enrollment`   
-  * **URL PREPROD** : `https://preprod.id360docaposte.com/api/1.0.0/process/{id}/enrollment`+  * **URL PREPROD** : `https://preprod.id360docaposte.com/api/1.0.0/process/{UUID}/enrollment`
   * **Requête (cURL)** :   * **Requête (cURL)** :
     <code bash>     <code bash>
 curl -X POST \ curl -X POST \
-"https://id360docaposte.com/api/1.0.0/process/{id}/enrollment" \+"https://id360docaposte.com/api/1.0.0/process/{UUID}/enrollment" \
 -H "accept: application/json" \ -H "accept: application/json" \
 -H "Authorization: Token 0123456789abcdef01234567" \ -H "Authorization: Token 0123456789abcdef01234567" \
Ligne 114: Ligne 117:
  
 === 🧾 Précisions sur les paramètres === === 🧾 Précisions sur les paramètres ===
 +  * Dans l'url, l'UUID correspond à l'ID du parcours
   * `callback_url` (**obligatoire**) : URL backend qui recevra en POST le **résultat complet** du parcours ID360   * `callback_url` (**obligatoire**) : URL backend qui recevra en POST le **résultat complet** du parcours ID360
   * `browser_callback_url` (**obligatoire**) : URL vers laquelle l’utilisateur est **redirigé côté navigateur**   * `browser_callback_url` (**obligatoire**) : URL vers laquelle l’utilisateur est **redirigé côté navigateur**
Ligne 129: Ligne 133:
 | Retour                      | `transactionId`, `qrCode`                                                  | `id` (dossier), `url`, `api_key`, `status`                                                        | | Retour                      | `transactionId`, `qrCode`                                                  | `id` (dossier), `url`, `api_key`, `status`                                                        |
 | Paramétrage du parcours     | Implicite                                                                  | Explicite via `{id}` du process configuré dans l’IHM                                              | | Paramétrage du parcours     | Implicite                                                                  | Explicite via `{id}` du process configuré dans l’IHM                                              |
-| Callback technique          | Non géré                                                                   | `callback_url` (backend) + `browser_callback_url` (front)                                          |+| Callback technique          | N\A                                                                 | `callback_url` (backend) + `browser_callback_url` (front)                                          |
 | Suivi personnalisé          | Non                                                                         | `client_reference` possible                                                                       | | Suivi personnalisé          | Non                                                                         | `client_reference` possible                                                                       |
 | Authentification            | Via Basic dans chaque appel                                                | Via token (`Authorization: Token ...`)                                                            | | Authentification            | Via Basic dans chaque appel                                                | Via token (`Authorization: Token ...`)                                                            |
Ligne 230: Ligne 234:
 ---- ----
  
-===== 📄 ÉTAPE 3 – AJOUTER UN DOCUMENT D’IDENTITÉ =====+===== 🪪 ÉTAPE 3 – AJOUTER UN DOCUMENT D’IDENTITÉ =====
  
 ==== 🔹 ShootID ==== ==== 🔹 ShootID ====
Ligne 240: Ligne 244:
     * `transactionId` (string) – identifiant de la transaction (**obligatoire**)     * `transactionId` (string) – identifiant de la transaction (**obligatoire**)
     * `file` (fichier) – image à uploader (**obligatoire**)     * `file` (fichier) – image à uploader (**obligatoire**)
-    * `type` (enum string) – type du document : `IDENTITY`, `RIB`, etc. (**obligatoire**) +    * `type` (enum string) – type de document géré : `Enum : IDENTITY`. (**obligatoire**) 
-    * `documentId` (integer) – identifiant du document (**obligatoire si plusieurs documents**)+    * `documentId` (integer) – identifiant du document (**obligatoire**)
   * **Options avancées** : page, géolocalisation, scanProvider, OCR/MRZ, traitement image   * **Options avancées** : page, géolocalisation, scanProvider, OCR/MRZ, traitement image
   * **Réponse exemple** :   * **Réponse exemple** :
Ligne 297: Ligne 301:
 | Réponse                       | JSON avec `status`, `documentId`, etc.                           | Réponse non détaillée (succès silencieux) ou `204` attendu                                     | | Réponse                       | JSON avec `status`, `documentId`, etc.                           | Réponse non détaillée (succès silencieux) ou `204` attendu                                     |
 | Traitements optionnels        | Oui (binarisation, OCR, cropping, etc.)                         | Gérés en amont dans le paramétrage du parcours                                                 | | Traitements optionnels        | Oui (binarisation, OCR, cropping, etc.)                         | Gérés en amont dans le paramétrage du parcours                                                 |
-| Type de document géré         | Enum : `IDENTITY`, `RIB`, `CHECK`, `CAR_REGISTRATION`, etc.     | Fixe : `id_document_image` (pour ce endpoint spécifique)                                       |+| Type de document géré         | Enum : `IDENTITY`, `RIB`, `CHECK`, `CAR_REGISTRATION`, etc.     | Fixe : `id_document_image` (pour cette étape spécifique)                                       |
  
 ---- ----
Ligne 375: Ligne 379:
  
 ---- ----
-===== 📄 ÉTAPE 5 – RECUPERATION DU RESULTAT FINAL =====+===== 📥 ÉTAPE 5 – RECUPERATION DU RESULTAT FINAL =====
 ==== 🔹 ShootID ==== ==== 🔹 ShootID ====
  
Ligne 386: Ligne 390:
  
 === Exemple de réponse === === Exemple de réponse ===
-  * Statut du scan : `OK`, `KO`, `READY_TO_BE_SCANNED+  * Statut du scan : `OK`, `KO`, `PROVIDER_COULD_NOT_PROCESS_ERROR
-  * Résultats de validation : MRZ, intégrité, correspondances...+  * Résultats de validation : MRZ, intégrité...
   * Données OCR : nom, prénom, date de naissance, sexe, numéro...   * Données OCR : nom, prénom, date de naissance, sexe, numéro...
   * Images générées : `imagePhoto`, `image1Cut`, `image2Cut`, `imageSignature`   * Images générées : `imagePhoto`, `image1Cut`, `image2Cut`, `imageSignature`
Ligne 461: Ligne 465:
   * Cette callback vous informe que le traitement est terminé.   * Cette callback vous informe que le traitement est terminé.
   * Une fois reçue, vous pouvez alors appeler `/enrollment/{id}/report`.   * Une fois reçue, vous pouvez alors appeler `/enrollment/{id}/report`.
-  * [Voir le guide des callbacks ici](https://wiki.id360docaposte.com/doku.php?id=guide_callbacks) +  * Voir le guide des callbacks [[guide_callback|ici]]
 ==== Comparatif ShootID / ID360 ==== ==== Comparatif ShootID / ID360 ====
  

This website uses cookies. By using the website, you agree with storing cookies on your computer. Also, you acknowledge that you have read and understand our Privacy Policy. If you do not agree, please leave the website.

Plus d’informations