API de Almacenamiento clave/valor

Devuelve como máximo 200 entradas en orden ascendente de clave. next_cursor es la última clave devuelta; pásela como after para obtener la siguiente página. next_cursor es nulo cuando no hay más entradas. Una sesión del panel lee aquí las entradas de su proyecto para la vista previa de la app web; el panel no tiene escritura de KV.

Lista los webhooks entrantes de la aplicación, los más antiguos primero (máximo 20), cada uno con la clave que escribe, su URL de ingestión y last_used_at una vez que ha escrito. El secreto nunca se devuelve aquí.

Crea un webhook entrante de clave/valor: una URL que escribe una clave de esta aplicación, para que un sistema externo (Zapier, Make, un punto de venta, un cron job, curl) envíe datos a pantallas con un POST HTTP; vea POST /api/applications/{application_id}/kv-webhooks/{webhook_id}/write. La clave no necesita existir aún.

La respuesta es el único lugar donde aparece el secreto (con la respuesta de rotación): guárdelo en el sistema de envío de inmediato; el servidor mantiene un resumen. Una aplicación tiene como máximo 20 webhooks (kv_webhook_limit_reached). Se añade kv_webhook.created. Un reintento exacto con la misma Idempotency-Key devuelve esta misma respuesta, incluido el secreto, durante veinticuatro horas.

Elimina el webhook. Su URL deja de funcionar de inmediato; la clave que escribió mantiene su valor. Añade kv_webhook.deleted.

Reemplaza el secreto del webhook y devuelve el nuevo, una vez. El secreto antiguo deja de funcionar de inmediato; actualice el sistema de envío. Añade kv_webhook.secret_rotated. Un reintento exacto con la misma Idempotency-Key devuelve esta misma respuesta, secreto incluido, durante veinticuatro horas.

La URL a la que un sistema externo envía el nuevo valor de una clave. Se autentica solo con el secreto propio del webhook en el encabezado Authorization: Bearer <secret>, o HTTP Basic con el id del webhook como usuario y el secreto como contraseña. Nunca se acepta un secreto en la URL o consulta.

Un webhook desconocido, uno de otra aplicación y un secreto incorrecto responden con el mismo 401. El cuerpo sin procesar, máximo 1 MiB, se convierte en el valor de la clave del webhook, y el encabezado Content-Type en su content_type (application/octet-stream cuando falta; un encabezado que no es un tipo de medio es invalid_request).

La escritura es PUT /api/applications/{application_id}/kv/{key} sin If-Match: reemplaza el valor, incrementa la revisión, se mide y se verifica su cuota como cualquier escritura K/V, es una solicitud API facturada que nunca se rechaza por saldo, y agrega kv.updated.

Idempotency-Key (de 8 a 200 caracteres) deduplica los reintentos de un remitente de una escritura durante veinticuatro horas, y la misma clave con otro cuerpo o tipo de contenido es idempotency_mismatch; sin ella cada envío es una nueva escritura. La respuesta son los nuevos metadatos de la clave, nunca su valor.

Como máximo 120 escrituras por minuto por webhook; cada una cuenta además para las tasas de escritura de la organización y de la clave (PUT /api/card-data/{key}).