API v1 · Status : opérationnel

Documentation API.

Cette API est utilisée pour vérifier l'éligibilité des utilisateurs lors de l'inscription à l'application ThePlace. Elle permet uniquement de confirmer qu'un compte Instagram ou TikTok est actif et d'en lire le nombre d'abonnés.

Base URLhttps://api.the-place.fr/v1

Données collectées

L'API n'accède qu'à des informations publiques du profil social vérifié. Aucune donnée privée n'est collectée. Aucun message, aucun contact, aucun email.

Identifiant du compte social (handle ou ID public)
Nombre d'abonnés
Informations publiques du profil (nom affiché, photo)
Statut actif / inactif du compte

Endpoint /status

Health check trivial. Toujours public, sans authentification.

GET/status

Réponse · 200 OK

{
  "status": "ok",
  "version": "1.0.0",
  "uptime": 1342580
}

Endpoint /verify

Vérifie qu'un compte social est actif et lit son nombre d'abonnés. Requiert un token d'API émis par ThePlace.

POST/verify🔒 Authentifié

Corps de la requête

{
  "network": "instagram",   // "instagram" | "tiktok"
  "handle":  "marie.nantes"
}

Réponse · 200 OK

{
  "active":      true,
  "followers":   2840,
  "display_name":"Marie L.",
  "avatar_url":  "https://cdn.the-place.fr/avatars/anon-1.jpg",
  "verified_at": "2026-02-14T09:41:00Z"
}

Réponse · 404 — compte introuvable

{
  "active": false,
  "error":  "account_not_found"
}

Sécurité

Toutes les communications sont sécurisées en HTTPS / TLS 1.3.
Authentification par Bearer token émis individuellement par ThePlace.
Rate limit : 60 requêtes / minute / token. 429 Too Many Requests au-delà.
Aucune donnée privée n'est stockée. Les réponses sont mises en cache 24h max.

Erreurs

Code	Signification
200	Succès — données retournées.
400	Requête malformée (paramètres manquants).
401	Token absent ou invalide.
404	Compte social introuvable.
429	Rate limit dépassé — réessayer plus tard.
5xx	Erreur serveur — ThePlace est notifiée automatiquement.