Chat est la messagerie d'équipe : organisations, canaux, messages, fichiers, recherche, annuaire et intégrations entrantes (webhooks).
- Base URL — prod :
https://chat.api.puwapi.com - Auth : JWT partagé (même Identity Hub). Temps réel via Convex.
Organisations & canaux¶
Base : /api/orgs
| Méthode | Route | Rôle |
|---|---|---|
| GET/POST | /api/orgs | Lister / créer |
| GET/PATCH | /api/orgs/{id} | Détail / modifier |
| GET | /api/orgs/{id}/members | Membres |
| DELETE | /api/orgs/{id}/members/{userId} | Retirer un membre |
| POST | /api/orgs/{id}/invites | Inviter |
| GET/POST | /api/orgs/{id}/channels | Canaux |
Base : /api/channels
| Méthode | Route |
|---|---|
| PATCH/DELETE | /api/channels/{id} |
| POST | /api/channels/{id}/members |
| POST | /api/channels/{id}/leave |
Recherche, annuaire, profil, fichiers¶
| Base | Méthode | Rôle |
|---|---|---|
/api/search | GET | Rechercher dans les messages |
/api/directory | GET | Annuaire des membres |
/api/profile/avatar | PUT | Avatar |
/api/files/upload | POST | Téléverser un fichier |
/api/files/{id}/content | GET | Récupérer un fichier |
Intégrations entrantes¶
Base : /api/integrations (webhooks entrants pour poster des messages)
| Méthode | Route | Rôle |
|---|---|---|
| GET/POST | /api/integrations | Lister / créer une intégration |
| PATCH/DELETE | /api/integrations/{id} | Modifier / supprimer |
| POST | /api/integrations/{token} | Point d'entrée webhook (par jeton) |
| POST | /api/integrations/messages | Poster un message via intégration |
Route interne¶
POST /api/internal/messages-sync — synchronisation de messages (M2M).
Chat partage l'identité (JWT HMAC) avec le reste de la plateforme et transmet le jeton aux fonctions Convex en argument (comme les autres modules temps réel).