fixThatMe API REST v1

Dernière mise à jour : 10 juillet 2026

API de gestion des feedbacks d'une organisation. Conçue pour être utilisée par des scripts, des intégrations ou des agents IA (lister les bugs signalés, les corriger, mettre à jour leur statut, répondre au rapporteur).

Base URL : https://www.fixthat.me/api/v1

Authentification

Toutes les requêtes exigent la clé secrète de l'organisation dans le header :

Authorization: Bearer sk_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

La clé se trouve dans le dashboard : Settings > Sécurité > Clé secrète API (visible par le propriétaire uniquement). Ne pas confondre avec la clé publique du widget (sk_live_...), qui ne fonctionne pas ici.

Réponse 401 si la clé est absente ou invalide. Toutes les réponses sont en JSON.

Modèle de données

Un feedback :

Cycle de vie recommandé d'un statut : new → in_review → in_progress → resolved. Les statuts closed et wont_fix sont terminaux. Chaque changement de statut notifie automatiquement le rapporteur par email (s'il a laissé son adresse) et alimente sa page de suivi publique.

Endpoints

Lister les feedbacks

GET /api/v1/feedbacks

Paramètres de query (tous optionnels) :

Réponse :

{
  "data": [ { "id": "...", "feedback_number": 2, "title": "...", "status": "new", ... } ],
  "pagination": { "page": 1, "limit": 50, "total": 12, "total_pages": 1 }
}

Exemple pour récupérer les bugs non traités :

curl -H "Authorization: Bearer sk_api_xxx" \
  "https://www.fixthat.me/api/v1/feedbacks?status=new&type=bug"

Détail d'un feedback

GET /api/v1/feedbacks/:id
GET /api/v1/feedbacks/:id?include_html=true

Retourne { "data": { ...feedback } }. Avec include_html=true, inclut page_html : le HTML complet de la page au moment du signalement (utile pour diagnostiquer, volumineux). Les coordonnées selection_x/y/width/height situent la zone sélectionnée par le rapporteur dans la page.

Mettre à jour un feedback

PATCH /api/v1/feedbacks/:id
Content-Type: application/json

Body (tous les champs sont optionnels, au moins un est requis) :

{ "status": "in_progress", "priority": "high", "type": "bug", "title": "...", "labels": ["front", "login"] }

Effets de bord automatiques d'un changement de status : email au rapporteur, mise à jour de sa page de suivi publique, webhooks et intégrations (Slack, Discord...) de l'organisation, historique d'activité (attribué à « API »).

Exemple pour marquer un feedback comme résolu :

curl -X PATCH -H "Authorization: Bearer sk_api_xxx" -H "Content-Type: application/json" \
  -d '{"status": "resolved"}' \
  "https://www.fixthat.me/api/v1/feedbacks/FEEDBACK_ID"

Commentaires

GET  /api/v1/feedbacks/:id/comments
POST /api/v1/feedbacks/:id/comments

POST body :

{ "content": "Corrigé dans la version déployée ce matin.", "is_public": true }

• is_public: false (défaut) : commentaire interne, visible uniquement dans le dashboard.
• is_public: true : visible par le rapporteur sur sa page de suivi publique, et il reçoit un email avec le contenu (s'il a laissé son adresse).

Réponse : 201 avec { "data": { ...comment } }.

Workflow type pour un agent IA

1. GET /feedbacks?status=new : récupérer les nouveaux signalements.
2. Pour chaque feedback : GET /feedbacks/:id?include_html=true : lire le commentaire, l'URL de la page, la zone sélectionnée et le HTML capturé pour diagnostiquer.
3. PATCH /feedbacks/:id avec {"status": "in_review"} puis {"status": "in_progress"} : tenir le rapporteur informé.
4. Corriger le problème dans le code du site concerné.
5. POST /feedbacks/:id/comments avec {"content": "...", "is_public": true} : expliquer la correction au rapporteur.
6. PATCH /feedbacks/:id avec {"status": "resolved"}.
7. Si le signalement n'est pas un bug réel : {"status": "wont_fix"} avec un commentaire public expliquant pourquoi.

Erreurs

Limites actuelles

• Pas de rate limiting explicite : restez raisonnable (< 10 req/s).
• Les screenshots sont des URLs publiques directement téléchargeables (PNG).
• Pas de webhook de création via l'API : les feedbacks sont créés par le widget uniquement.