---
title: "Tester un abonnement webhook"
method: POST
path: "/webhooks/{id}/test"
---

# Tester un abonnement webhook

`POST /webhooks/{id}/test`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/webhooks/{id}/test`
- Auth: HTTP bearer

Envoie tout de suite à l'URL de l'abonnement une livraison d'essai signée (genre test), sans reprise, et rend le code HTTP reçu. Un essai réussi réactive un abonnement coupé. Coût : 0 crédit par appel réussi.

## Path parameters

- `id` string, uuid, required: Identifiant de l'abonnement.

## Request body

- object

## Response `200`

Écriture faite et débitée selon le barème.

- object
  - `id` string, required
  - `reussi` boolean, required: Vrai si votre serveur a répondu par un code 2xx.
  - `statut_http` integer, nullable, required: Code HTTP reçu ; null si votre serveur n'a pas répondu.
  - `duree_ms` integer, required
  - `erreur` string, nullable, required: Pourquoi la livraison n'a pas abouti ; null si elle a abouti.
  - `reactive` boolean, required: Vrai si l'abonnement était coupé et a été réactivé par ce test réussi.
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante ; Palier insuffisant
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)