Référence de l'API
L'objet utilisateur
Renvoyé par /oauth/token.php, /oauth/userinfo.php et l'API des applications officielles.
| Champ | Type | Description |
|---|---|---|
id | entier | Identifiant unique et permanent du compte, le même dans toutes les applications. |
username | texte | Nom d'utilisateur (lettres et chiffres). Peut changer : ne l'utilisez pas comme identifiant. |
nom_complet | texte | Nom affiché (le nom d'utilisateur s'il est vide). |
verifie | 0 / 1 | Identité vérifiée par Kinda-e (badge). |
photo | adresse ou null | Photo de profil (carré 400 × 400, WebP). |
| Applications officielles uniquement : | ||
email, email_verifie | texte, 0 / 1 | Email de récupération et s'il a été vérifié. |
telephone, adresse | texte ou null | Coordonnées, si la personne les a renseignées. |
Un compte désactivé, banni ou supprimé n'est plus renvoyé : la connexion est refusée et l'API répond comme si le compte n'existait pas.
GET /oauth/authorize.php
Dans le navigateur. Paramètres : response_type=code, client_id, redirect_uri, state, et facultatif prompt (select_account ou none). Retour : ?code=…&state=… ou ?error=…&state=…. Détails : guide.
POST /oauth/token.php
De serveur à serveur. Authentification : Authorization: Basic ou client_id + client_secret dans le corps.
| Paramètre | Valeur |
|---|---|
grant_type | authorization_code |
code | Le code reçu (5 minutes, une seule utilisation). |
redirect_uri | La même adresse que pour authorize. |
Réponse 200 : access_token, token_type (Bearer), expires_in (3600 secondes), user.
GET /oauth/userinfo.php
Relit les informations du compte tant que le jeton est valable (1 heure).
GET https://kinda-e.com/oauth/userinfo.php
Authorization: Bearer 9f2c…Réponse 200 : l'objet utilisateur. Réponse 401 {"error":"invalid_token"} si le jeton est expiré, inconnu, ou si le compte n'est plus actif.
Codes d'erreur
| Code HTTP | error | Signification |
|---|---|---|
| 401 | invalid_client | client_id ou client_secret faux, ou application désactivée. |
| 400 | unsupported_grant_type | grant_type doit valoir authorization_code. |
| 400 | invalid_grant | Code inconnu, déjà utilisé, expiré, ou redirect_uri différente. |
| 401 | invalid_token | Jeton d'accès invalide ou expiré. |
| 405 | invalid_request | Mauvaise méthode HTTP (POST attendu). |
API des applications officielles
Réservée aux applications de Kinda-e (premiere_partie). Toutes en POST, de serveur à serveur, avec client_id et client_secret. Réponse : {"success": true, "user": {…}} ou {"success": false, "message": "…"}.
| Adresse | Paramètres | Rôle |
|---|---|---|
/api/verifier.php | username, password | Connexion depuis un écran natif (application mobile). Limité à 5 échecs par compte en 15 minutes. Un compte désactivé ou banni reçoit success: false, le motif dans message et statut (suspendu ou banni). |
/api/inscription.php | nom_complet, username, password | Crée un compte Kinda-e depuis l'écran d'inscription de l'application. |
/api/utilisateur.php | id | Rafraîchit la copie d'un compte (nom, photo...). success: false si le compte n'est plus actif : déconnectez la personne. |