Différences

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

--- guide_du_developpeur_service [2025/08/08 12:07] – [6. Upload de la pièce d’identité] admin
+++ guide_du_developpeur_service [2026/01/26 14:45] (Version actuelle) – admin
@@ Ligne 29: / Ligne 29: @@
   - **Finalisation du dossier** : Finalise l'enrôlement
   - **Récupération du rapport** : Vous pourrez récupérer le rapport du dossier utilisateur en utilisant l'identifiant du dossier obtenu lors de la deuxième étape. Ce rapport contiendra le statut du dossier ainsi que des informations techniques et sur les différentes étapes de vérification.
+  - **Récupération de l'idClaim (en option)** : Uniquement dans le cas de la signature électronique avancée, retourne un ASIC-E.
 ----
@@ Ligne 63: / Ligne 64: @@
 ^ Paramètre  ^ Obligatoire ^ Détails ^
-| ''username'' | Oui | Identifiant de connexion |
+| ''username'' | Oui | Identifiant de connexion (par défaut le login de l'application) |
 | ''password'' | Oui | Mot de passe associé |
 | ''token'' | Non (sauf si admin) | Inutile pour les comptes ''application''. Obligatoire uniquement pour les comptes ''admin'' avec authentification à deux facteurs. |
@@ Ligne 215: / Ligne 216: @@
   "country": "Users country",
   "phone_number": "Users phone number",
-  "group": "string"
+  "group": "string",
+  /* Seulement pour les parcours avec génération d'idclaim */
+  "custom_data": {
+    "authenticators" : {
+        "phone_number" : "+33668001418"
+    }
+  }
 }
 </code>
@@ Ligne 226: / Ligne 233: @@
   * **''client_reference''** : facultatif – Permet d’associer un identifiant interne à votre système. Utile pour les croisements en cas d’annulation ou d’échec.
   * **''callback_endpoints''** : obligatoire – un callback endpoint permet à ID360 de notifier automatiquement votre système lorsqu’un dossier atteint un certain statut (ex. échec, annulation, fin de traitement), via une requête HTTP POST envoyée à l’URL que vous avez fournie. Les headers sont optionnels, vous pouvez les utiliser comme des headers d'identification lors de la réception des callbacks.
+  * **''custom_data''> ''authenticators'' > ''phone_number''** : obligatoire dans le cadre de la génération d'un **idclaim**.
   * **''last_name, first_name, address_line_1/2/3, zip_code, city, country, phone_number, email''** : facultatifs – Informations utilisateur à titre **informatif uniquement** (aucun contrôle réalisé dessus).
   * **''group''** : facultatif – permettra de faire un export des consommations en fonction de groupes.
-> Pour plus de détails sur les callback_endpoints, consultez [[https://wiki.id360docaposte.com/doku.php?id=guide_callbacks|ce guide dédié]].
+> Pour plus de détails sur les callback_endpoints, consultez [[https://id360.doca-id.com/doku.php?id=guide_callbacks|ce guide dédié]].
 ----
@@ Ligne 383: / Ligne 391: @@
 <code bash>
 curl -X POST \
-  "https://id360docaposte.com/api/1.0.0/enrollment/flow/consent/?accepted_cgu=true&accepted_biometry=true" \
+  "https://id360docaposte.com/api/1.0.0/enrollment/flow/consent/?accepted_system_cgu=true&accepted_biometry=true" \
   -H "accept: */*" \
   -H "x-api-key: <votre_api_key>" \
@@ Ligne 393: / Ligne 401: @@
 <code bash>
 curl -X POST \
-  "https://preprod.id360docaposte.com/api/1.0.0/enrollment/flow/consent/?accepted_cgu=true&accepted_biometry=true" \
+  "https://preprod.id360docaposte.com/api/1.0.0/enrollment/flow/consent/?accepted_system_cgu=true&accepted_biometry=true" \
   -H "accept: */*" \
   -H "x-api-key: <votre_api_key>" \
@@ Ligne 409: / Ligne 417: @@
 === 💬 Commentaire ===
-  * ✅ Si vous ne déposez qu’un **document d’identité ou complémentaire**, utilisez uniquement `accepted_cgu=true`.
+  * ✅ Si vous ne déposez qu’un **document d’identité ou complémentaire**, utilisez uniquement `accepted_system_cgu=true`.
   * ✅ Si vous déposez également un **selfie**, ajoutez impérativement `accepted_biometry=true` dans l’URL.
@@ Ligne 416: / Ligne 424: @@
 Dans la configuration du parcours, il est indispensable de sélectionner **au moins une donnée à comparer**.
 Pour ce faire, accédez au bloc **''Saisie d'informations''** et choisissez les éléments à comparer.
+Ensuite, sous le bloc **''Sélection des contrôles''**, cliquez sur **''Idenitité''** et cochez les contrôles que vous désirez.
+Par exemple "Vérifier la coherence du nom d'usage avec l'identité".
 [[https://preprod.id360docaposte.com/static/swagger.html#/Enrollment%20Control/control_data|Voir la méthode dans le Swagger]]
@@ Ligne 448: / Ligne 459: @@
       - ''birth_date'' → date de naissance
   * Pour connaître les données attendues, vous pouvez interroger :
     [[https://preprod.id360docaposte.com/api/1.0.0/enrollment/flow/enrollment_info]]
 ----
@@ Ligne 462: / Ligne 473: @@
 Le body doit simplement contenir **la donnée à vérifier**, au format brut (texte ou valeur simple).
+Attention, les données doivent être poussées en UTF-8.
 ----
@@ Ligne 507: / Ligne 520: @@
   * **`total_pages`** : indique le **nombre total de pages** à envoyer pour le document (ex : `2` pour une CNI recto/verso).
   * **`uploaded_page`** : index (commençant à `0`) de la page actuellement envoyée.
-  * Formats autorisés : jpg, jpeg, png, pdf, heic
+  * **Formats autorisés** : jpg, jpeg, png, pdf, heic
-  * Taille maximale par document : 9,5 Mo
+  * **Taille maximale** par document : 9,5 Mo
 ----
@@ Ligne 557: / Ligne 570: @@
   * **`@selfie.PNG`** : remplacez par le chemin vers votre fichier image (ex. photo prise par l’utilisateur).
   * **`total_pages`** : doit être `1` pour un selfie.
   * **`uploaded_page=0`** : reste à `0` car il n’y a qu’une seule page.
+  * **Formats autorisés** : jpg, jpeg, png, pdf, heic
+  * **Taille maximale** par document : 9,5 Mo
 ----
@@ Ligne 654: / Ligne 669: @@
 **HTTP Status** : ''200 OK''
 **Format de la réponse** : JSON
@@ Ligne 737: / Ligne 753: @@
 [[https://preprod.id360docaposte.com/static/swagger.html#/enrollment/enrollment_proof_slip|Téléchargement du PDF du rapport]]
+====== 10. Récupération de l'idClaim ======
+[[https://preprod.id360docaposte.com/static/swagger.html#/enrollment/enrollment_idclaim|Voir la méthode dans le Swagger]]
+----
+=== 🔧 Requête CURL – Production ===
+<code javascript>
+curl -X GET \
+  "https://id360docaposte.com/api/1.0.0/enrollment/{id}/idclaim" \
+  -H "accept: application/json" \
+  -H "Authorization: Token 0123456789abcdef01234567"
+</code>
+----
+=== 🔧 Requête CURL – Préproduction ===
+<code javascript>
+curl -X GET \
+  "https://preprod.id360docaposte.com/api/1.0.0/enrollment/{id}/idclaim" \
+  -H "accept: application/json" \
+  -H "Authorization: Token 0123456789abcdef01234567"
+</code>
+----
+=== 🛠 Informations techniques ===
+  * **''{id}''** : identifiant du dossier utilisateur, récupéré lors de sa création.
+  * **Paramètres** : aucun paramètre attendu dans cette requête.
+----
+=== ✅ Résultat attendu ===
+**HTTP Status** : ''200 OK''
+**Format de la réponse** : ASIC-E
+----
+=== 💬 Commentaires ===
+  * Le token de connexion est **valable 15 minutes**, renouvelées à chaque appel utilisant ce token.
+  * En cas de token expiré ou absent, vous recevrez une **erreur 401 Unauthorized**.
+  * Tant que votre token est valide, **il ne faut pas réutiliser la méthode ''login''**.
+  * Le token s’utilise dans l’en-tête des appels suivants sous la forme :
+<code>
+Authorization: Token le_token_retourné_par_login
+</code>