API Stockage clé/valeur

Retourne au maximum 200 entrées dans l’ordre croissant des clés. next_cursor est la dernière clé retournée ; renvoyez-la comme after pour récupérer la page suivante. next_cursor est nul quand il n’y a plus d’entrées. Une session du tableau de bord lit ici les entrées de son projet pour l’aperçu de l’application web ; le tableau de bord n’a aucune écriture KV.

Liste les webhooks entrants de l’application, les plus anciens d’abord (au maximum 20), chacun avec la clé qu’il écrit, son URL d’ingestion et last_used_at une fois qu’il a écrit. Le secret n’est jamais retourné ici.

Crée un webhook clé/valeur entrant : une URL qui écrit une clé de cette application, pour qu’un système externe (Zapier, Make, un point de vente, un cron, curl) pousse des données vers les écrans avec un POST HTTP ; voir POST /api/applications/{application_id}/kv-webhooks/{webhook_id}/write. La clé peut ne pas encore exister.

La réponse est le seul endroit où le secret apparaît (avec la réponse de rotation) : stockez-le immédiatement dans le système d’envoi ; le serveur conserve un résumé. Une application a au plus 20 webhooks (kv_webhook_limit_reached). Ajoute kv_webhook.created. Une nouvelle tentative exacte avec la même Idempotency-Key renvoie cette même réponse, secret inclus, pendant vingt-quatre heures.

Supprime le webhook. Son URL cesse de fonctionner immédiatement ; la clé qu’il a écrite conserve sa valeur. Ajoute kv_webhook.deleted.

Remplace le secret du webhook et retourne le nouveau, une fois. L’ancien secret cesse de fonctionner immédiatement ; mettez à jour le système d’envoi. Ajoute kv_webhook.secret_rotated. Une nouvelle tentative exacte avec la même Idempotency-Key retourne cette même réponse, secret inclus, pendant vingt-quatre heures.

L’URL à laquelle un système externe envoie la nouvelle valeur d’une clé. Elle s’authentifie uniquement avec le secret du webhook dans l’en-tête Authorization : Bearer <secret>, ou HTTP Basic avec l’ID du webhook comme nom d’utilisateur et le secret comme mot de passe. Un secret dans l’URL ou la requête n’est jamais accepté.

Un webhook inconnu, d’une autre application et un mauvais secret répondent tous par le même 401. Le corps brut, au maximum 1 Mio, devient la valeur de la clé du webhook, et l’en-tête Content-Type son content_type (application/octet-stream en l’absence ; un en-tête qui n’est pas un type média est invalid_request).

L’écriture est PUT /api/applications/{application_id}/kv/{key} sans If-Match : elle remplace la valeur, incrémente la révision, est mesurée et soumise à quota comme toute écriture K/V, compte comme une requête API facturée qui n’est jamais refusée en raison du solde, et ajoute kv.updated.

Idempotency-Key (de 8 à 200 caractères) déduplique les nouvelles tentatives d’un expéditeur pour une écriture pendant vingt-quatre heures, et la même clé avec un autre corps ou type de contenu donne idempotency_mismatch; sans elle, chaque envoi est une nouvelle écriture. La réponse est les nouvelles métadonnées de la clé, jamais sa valeur.

Au maximum 120 écritures par minute et par webhook; chacune compte aussi dans les taux d’écriture de l’organisation et de la clé (PUT /api/card-data/{key}).