Introduction

Cette documentation vous guide à travers les étapes nécessaires pour intégrer le Pixxle Login dans votre application ou site web. L’authentification est basée sur le standard OAuth 2.0, garantissant une sécurité optimale et une expérience utilisateur fluide.

 

Prérequis

Avant de commencer, assurez-vous de posséder les éléments suivants :

• Un client_id et un client_secret fournis dans la console lors de la création de votre application Pixxle Login.
• Une URI de redirection configurée dans le tableau de bord de votre application Pixxle Login.

 

Se rendre sur la console

 

Demande d’autorisation

Initiez le flux d’authentification en redirigeant l’utilisateur vers le serveur d’autorisation de Pixxle avec les paramètres appropriés.

Voici les paramètres nécessaires :

• client_id : Identifiant unique de votre application.
• redirect_uri : URL vers laquelle l’utilisateur sera redirigé après l’authentification.
• response_type : Doit être code indiquant que vous attendez un code d’autorisation.
• scope : Définit l’étendue des accès demandés (par exemple, accès complet ou accès limité).
• state : Chaîne aléatoire générée par votre application pour prévenir les attaques CSRF.

 

Url de demande d’autorisation :

https://www.pixxle.me/oauth/v2/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code&scope=REQUESTED_SCOPES&state=YOUR_UNIQUE_STATE

 

 

Réception du code d’autorisation

Après l’authentification et l’autorisation par l’utilisateur, Pixxle Login redirigera vers l’URL spécifiée avec un code d’autorisation que vous utiliserez pour demander un token d’accès.

 

Échange du code d’autorisation contre un token d’accès

Effectuez une requête POST au serveur de token de Pixxle pour échanger le code d’autorisation contre un token d’accès. Incluez les paramètres suivants dans votre requête :

• client_id : Votre identifiant client.
• client_secret : Votre secret client.
• code : Le code d’autorisation reçu.
• grant_type : Doit être authorization_code.
• redirect_uri : Doit correspondre à l’URI de redirection utilisé lors de la demande initiale.

 

URL d’exemple de requête de token

POST https://www.pixxle.me/v2/oauth/token
Content-Type: application/x-www-form-urlencoded

client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&code=AUTHORIZATION_CODE&grant_type=authorization_code&redirect_uri=YOUR_REDIRECT_URI

 

 

Utiliser le token d’accès

Avec le token d’accès, votre application peut requérir des ressources ou des données utilisateur via les API Pixxle. Assurez-vous de gérer le token avec sécurité et de respecter la confidentialité des données de l’utilisateur.

 

Gestion des erreurs

Prévoyez la gestion des erreurs tout au long du flux, en incluant des vérifications pour les réponses d’erreur du serveur d’autorisation et du serveur de token. Traitez également les erreurs de connexion réseau ou les exceptions.