Documentation développeurs

Kinda-e est le service de comptes de Gromonde, des sites de cours, des jeux et des applications Kinda-e. Votre site ou votre application peut lui aussi proposer « Se connecter avec Kinda-e » :

• vos utilisateurs se connectent avec le compte qu'ils ont déjà, sans formulaire d'inscription ;
• vous ne stockez jamais de mot de passe : il n'est tapé que sur kinda-e.com ;
• chaque personne a le même identifiant (id) dans toutes les applications Kinda-e.

Comment ça marche

Kinda-e utilise le principe d'OAuth 2.0 (flux « authorization code »), comme « Se connecter avec Google » :

Votre site                                Kinda-e
   | 1. bouton « Se connecter avec Kinda-e »  |
   |----------------------------------------->|  /oauth/authorize.php
   |                                          |  2. la personne se connecte ou choisit son compte
   |  3. retour avec ?code=...&state=...      |
   |<-----------------------------------------|  vers votre adresse de retour
   |  4. code + client_secret (serveur à serveur)
   |----------------------------------------->|  /oauth/token.php
   |  5. jeton d'accès + infos du compte       |
   |<-----------------------------------------|
   |  6. vous ouvrez votre propre session     |

Deux types d'applications

Obtenir un accès

1. Écrivez au support, catégorie « Développeurs » en indiquant : le nom de votre application, son site, et la ou les adresses de retour exactes (par ex. https://monsite.com/kindae/retour.php).
2. L'équipe enregistre l'application et vous transmet un client_id et un client_secret. Le secret n'est affiché qu'une fois : gardez-le précieusement, côté serveur uniquement.
3. Suivez le guide Se connecter avec Kinda-e.

Adresses

Tout se fait en HTTPS. Les réponses de l'API sont en JSON, encodées en UTF-8.