Avis

Un avis est un message que votre projet adresse à l'équipe du service. Cette ressource en dépose un et relit ceux qui ont déjà été déposés. Un avis ne peut être ni modifié ni retiré une fois envoyé.

Les appels

Méthode	Chemin	Droit requis
GET	`/v1/feedback`	`feedback:read`
GET	`/v1/feedback/<feedback_id>`	`feedback:read`
POST	`/v1/feedback`	`feedback:write`

<feedback_id> est un identifiant d'avis, préfixé fbdk_.

L'objet avis

Champ	Type	Description
`id`	chaîne	L'identifiant de l'avis, préfixé `fbdk_`.
`object`	chaîne	Toujours `feedback`.
`topic`	chaîne	Le sujet du message.
`message`	chaîne	Le message lui-même.
`status`	chaîne	Jusqu'où le message a été traité.
`created_at`	entier	Le moment où il a été envoyé, en secondes Unix.
`updated_at`	entier	Dernière modification, en secondes Unix.

status est défini par l'équipe qui lit le message, et non par vous. C'est le seul champ qui change après un dépôt, et c'est pourquoi updated_at peut être postérieur à created_at.

Déposer un avis

POST /v1/feedback dépose un message. Les deux champs sont obligatoires.

Paramètre	Type	Obligatoire	Description
`topic`	chaîne	oui	Un sujet court. Tout ce qui dépasse 200 caractères est tronqué.
`message`	chaîne	oui	Le message. Sa longueur n'est pas limitée.

curl

curl -X POST https://api.think.ultineo.com/v1/feedback \
  -H "Authorization: Bearer sk-project-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Run latency on the Starter plan",
    "message": "Runs queued at 09:00 UTC take about four times longer than the rest of the day."
  }'

json

{
  "code": 201,
  "title": "Created",
  "response": {
    "id": "fbdk_9e1750cab38df2461c07",
    "object": "feedback",
    "topic": "Run latency on the Starter plan",
    "message": "Runs queued at 09:00 UTC take about four times longer than the rest of the day.",
    "status": "new",
    "created_at": 1754209800,
    "updated_at": 1754209800
  }
}

Code	Message	Cause
422	`topic is required.`	`topic` était absent ou vide.
422	`message is required.`	`message` était absent ou vide.

Astuce — Un topic tronqué n'est pas une erreur : la réponse est donc l'endroit où vérifier ce qui a réellement été enregistré. Gardez le sujet court et mettez le détail dans message.

Lire les avis

GET /v1/feedback renvoie ce que le projet a envoyé, les plus récents d'abord, et GET /v1/feedback/<feedback_id> renvoie un seul message. Un avis appartenant à un autre projet donne 404 et Feedback not found.

curl

curl https://api.think.ultineo.com/v1/feedback \
  -H "Authorization: Bearer sk-project-YOUR_KEY"

json

{
  "code": 200,
  "title": "OK",
  "response": {
    "object": "list",
    "data": [
      {
        "id": "fbdk_9e1750cab38df2461c07",
        "object": "feedback",
        "topic": "Run latency on the Starter plan",
        "status": "new",
        "created_at": 1754209800,
        "updated_at": 1754209800
      }
    ],
    "total": 1
  }
}

La liste omet message. Lisez une entrée pour l'obtenir.

Envoyer des commentaires

Contacter le support

Conditions d'utilisation Confidentialité Cookies