API:Account creation/fr

Création d'un compte
Le processus possède trois étapes générales :


 * 1) Récupérez les champs de  et le jeton de.
 * 2) Envoyez une requête POST avec le jeton récupéré, les informations utilisateur et les autres champs, et l'URL de retour de l'API.
 * 3) Gérez la réponse, qui peut impliquer d'autres requêtes POST pour fournir davantage d'informations.

Exemple 1: Traitement sur un wiki sans extensions d'authentification particulières
Un wiki sans extensions d'authentification spéciales peut être plutôt simple à traiter. Si votre code sait quels sont les champs qui seront obligatoires, il peut sauter l'appel à et simplement supposer les champs nécessaires (par exemple le nom de l'utilisateur, le mot de passe &amp; le mot de passe retapé, l'adresse de courriel, éventuellement le nom réel).

Exemple de code
create_account.py

Exemple 2: Traitement sur un wiki avec une extension CAPTCHA
Remarquez que la première étape ci-dessous pourrait, si vous le voulez, être faite en deux parties: la première pour récupérer les champs disponibles de et la seconde pour récupérer le jeton de.

Exemple de code
Notez que ce morceau de code sépare les requêtes et , et suppose généralement qu'il y aura un CAPTCHA et pas d'autres complications.

Première étape: récupérer les champs disponibles de et le jeton de
La récupération de et  est très similaire à l'exemple précédent, cela n'est donc pas répété ici. La liste des requêtes retournées par va contenir en même temps les définitions pour l'extension CAPTCHA et l'extension OpenID.

Seconde étape : répondre au CAPTCHA et sélectionner l'authentification OpenID.
Le navigateur de l'utilisateur va alors être redirigé vers le redirecttarget fourni.

Ensuite, l'authentification par OpenID va s'effectuer, avant de rediriger vers Special:OpenIDConnectReturn sur le wiki, qui validera la réponse de OpenID et renverra l'utilisateur vers le createreturnurl renseigné dans la première requête POST vers l'API, avec les paramètres code et state ajoutés.

L'utilisateur reprend alors le contrôle du processus à ce point et effectue la requête suivante vers l'API.

Troisième étape : après l'authentification par OpenID.
Le cient met code et state qu'il renvoie à l'API. La réponse de l'API comporte l'extension de l'authentification à deux facteurs qui demande à l'utilisateur de définir son second facteur.

Maintenant le client va demander à l'utilisateur de définir un nouveau compte dans son application à authentification à deux facteurs et entrer le code actuel, ou bien autoriser l'utilisateur à sauter l'authentification à deux facteurs. Faisons comme si l'utilisateur effectuait cette authentification à deux facteurs.

Quatrième étape : choisir l'authentification à deux facteurs.
La création du compte a finalement réussi.

Si la création du compte échoue à un moment quelconque, une réponse avec un statut FAIL sera retournée, au côté d'un message qui s'affichera chez l'utilisateur.

Notes additionnelles

 * Les créations de comptes sont enregistrées dans Special:log/newusers.

Si vous êtes connecté, votre nom d'utilisateur sera également enregistré si vous créez un compte.


 * Quand vous excutez les parties de code fournies sur cette page, rappelez-vous que :
 * Une fois qu'un compte est créé sur un wiki, il ne peut pas être supprimé.
 * Utilisez toujours comme point de terminaison, pour ne pas créer accidentellement de comptes sur les wikis de production.
 * Les administrateurs de site MediaWiki et les développeurs d'extensions peuvent désactiver ces fonctionalités de l'API en insérant la ligne suivante dans le fichier de configuration :