API - Aperçu

Documentation de l'API mobile Kiwisocial pour les développeurs.

Introduction

L'API Kiwisocial permet d'interagir avec la plateforme de manière programmatique. Les réponses sont au format JSON. Les requêtes utilisent des paramètres HTTP classiques (GET ou POST).

URL de base

https://kiwisocial.eu/mobile_api/

Important : Il n'existe pas d'API sur api.kiwisocial.eu/v1/. Utilisez uniquement l'URL ci-dessus.

Authentification : La plupart des endpoints exigent session_id (token reçu à la connexion). Certains endpoints publics (profil, recherche…) fonctionnent sans.

Authentification

Connectez-vous via POST /login, récupérez auth.auth_token, puis passez-le comme session_id dans vos requêtes. Il n'y a pas de header Authorization: Bearer.

Obtenir un token

POST https://kiwisocial.eu/mobile_api/login
Content-Type: application/x-www-form-urlencoded

[email protected]&password=votre_mot_de_passe&device_type=android

Réponse :

{
  "code": 200,
  "message": "User logged in successfully",
  "data": { ... },
  "auth": {
    "auth_token": "c625cc16eb00960f076c1378c7b84ede...",
    "refresh_token": "de25cc16eb00960f076c1378c7b84ede...",
    "auth_token_expiry": 1916742375
  }
}

Format des requêtes

GET : paramètres en query string (?session_id=...&user_id=123)
POST : paramètres en application/x-www-form-urlencoded ou multipart/form-data (uploads)
JSON body : non supporté nativement — n'envoyez pas Content-Type: application/json seul

Exemple authentifié

GET https://kiwisocial.eu/mobile_api/feeds?session_id=VOTRE_TOKEN&page_size=20

Format des réponses

{
  "code": 200,
  "message": "OK",
  "data": { ... }
}

Codes de réponse (`code`)

200

Succès

204

Aucune donnée

400 / 401

Requête ou token invalide

402

Identifiants incorrects

500

Erreur serveur

Pagination

offset — curseur de pagination
page_size — éléments par page (20 recommandé)

GET /feeds?session_id=VOTRE_TOKEN&page_size=20&offset=abc123

Endpoints principaux

POST /login, /oauth, /refresh_access_token
/profile, /profile_posts, /follow
/feeds, /publish_post, /like_post, /publication_repost
/get_chats, /send_message
/get_notifications

Liste complète : Points de terminaison.