Développez avec InRealLife

1. Connecter votre outil

Chaque connexion correspond à une personne dans une seule appli : Hangout ou Bondable. L'authentification utilise OAuth 2.1 avec PKCE (S256). Il n'y a ni clé API, ni secret client, ni compte d'entreprise.

1. Découvrez les endpoints. GET /.well-known/oauth-authorization-server fournit les adresses utilisées ci-dessous.
2. Enregistrez votre outil une seule fois : appelez POST /oauth/register avec client_name et redirect_uris. Vous recevez un client_id.
3. Redirigez la personne vers /oauth/authorize avec response_type=code, votre client_id, votre redirect_uri, un scope, un state et un code_challenge accompagné de code_challenge_method=S256. Elle saisit son adresse e-mail, puis appuie sur Autoriser dans Hangout ou Bondable sur son téléphone. Sans téléphone à portée de main, elle peut utiliser un code reçu par e-mail.
4. Échangez le code contre des jetons via POST /oauth/token, avec votre code_verifier. Le jeton d'accès est valable une heure ; chaque jeton de renouvellement ne peut être utilisé qu'une fois.

Deux valeurs sont possibles pour scope :

• see : consulter les activités à proximité, le détail d'une activité, les activités de la personne et les types d'activités.
• see join, présenté à la personne sous le libellé « Plan for me » : les mêmes possibilités, avec en plus la préparation d'une activité, la demande de participation, la désinscription et l'envoi d'un signal au groupe.

Dans l'appli, la personne retrouve ses outils connectés sous Compte → Apps connectées, ainsi que l'historique des actions de chacun. Déconnecter un outil révoque immédiatement ses jetons.

Les outils en ligne de commande utilisent le flux d'autorisation par appareil : votre outil affiche un code que la personne saisit dans l'appli.

2. Trouver des activités

curl 'https://api.inreallife.technology/v1/activities?latitude=48.8566&longitude=2.3522' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

La recherche renvoie jusqu'à dix activités à venir, dans un rayon de 25 km par défaut, modifiable avec radius_km, et dans une limite de 100 km autour de la zone de la personne. GET /v1/area permet de consulter cette zone. Utilisez ensuite GET /v1/activities/{id} pour obtenir le détail d'une activité et GET /v1/schedule pour consulter les activités de la personne.

3. Préparer une activité ou une participation

Votre outil ne publie jamais d'activité et ne confirme jamais une participation. Il prépare la demande ; IRL effectue les mêmes vérifications que lors d'une publication ou d'une inscription, puis renvoie un lien si elles réussissent. La personne ouvre ce lien sur son téléphone et appuie sur Publier ou Participer. C'est cette confirmation qui l'engage.

curl https://api.inreallife.technology/v1/prepared_activities \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' -H 'Content-Type: application/json' \
  -d '{"activity": {"type": "games", "title": "Board game night", "starts_at": "2026-11-06T19:30:00+01:00",
       "venue_name": "Le Dernier Bar", "address": "…", "area": "Bastille", "city": "Paris",
       "country_code": "FR", "latitude": 48.853, "longitude": 2.369, "max_participants": 6}}'

• En cas de refus : un code d'erreur et un message précisent les corrections à apporter (too_far, invalid avec le détail des champs concernés…). Aucun lien n'est renvoyé.
• Si les vérifications réussissent : {"url": "https://hangout.inreallife.technology/go/…", "expires_at": "…"}. Transmettez le lien tel quel : il est à usage unique, valable quinze minutes et réservé à cette personne.
• Une seule activité préparée par personne : toute nouvelle préparation remplace la précédente.
• POST /v1/activities/{id}/join_link suit le même principe pour participer : les vérifications sont effectuées immédiatement, mais seule la confirmation sur le téléphone valide la participation.

Les mêmes opérations sont disponibles via MCP : my_area, my_schedule, prepare_activity, join_activity, leave_activity, send_signal.