API Archiviazione chiave/valore

Restituisce al massimo 200 voci in ordine crescente di chiave. next_cursor è l’ultima chiave restituita; passala come after per ottenere la pagina successiva. next_cursor è null quando non ci sono più voci. Una sessione della dashboard legge qui le voci del suo progetto per l’anteprima dell’app web; la dashboard non ha scrittura KV.

Elenca i webhook key/value in ingresso dell’applicazione, dal più vecchio (massimo 20), ognuno con la chiave scritta, la sua URL di ingestione e last_used_at una volta scritta. Il segreto non è mai restituito qui

Crea un webhook in ingresso chiave/valore: un URL che scrive una chiave di questa applicazione, così un sistema esterno (Zapier, Make, un punto vendita, un cron job, curl) invia dati agli schermi con un POST HTTP; vedi POST /api/applications/{application_id}/kv-webhooks/{webhook_id}/write. La chiave può non esistere ancora.

La risposta è l’unico luogo in cui appare il segreto (con la risposta di rotazione): memorizzalo subito nel sistema di invio; il server conserva un digest. Un’applicazione ha al massimo 20 webhook (kv_webhook_limit_reached). Aggiunge kv_webhook.created. Un retry esatto con la stessa Idempotency-Key restituisce la stessa risposta, segreto incluso, per ventiquattro ore.

Elimina il webhook. La sua URL smette di funzionare immediatamente; la chiave scritta mantiene il suo valore. Aggiunge kv_webhook.deleted.

Sostituisce il segreto del webhook e restituisce quello nuovo, una volta. Il vecchio segreto smette di funzionare subito; aggiorna il sistema di invio. Aggiunge kv_webhook.secret_rotated. Un retry esatto con la stessa Idempotency-Key restituisce questa stessa risposta, segreto incluso, per ventiquattro ore.

L’URL a cui un sistema esterno invia il nuovo valore di una chiave. Si autentica solo con il segreto del webhook nell’intestazione Authorization: Bearer <secret>, o HTTP Basic con l’ID webhook come nome utente e il segreto come password. Un segreto nell’URL o nella query non è mai accettato.

Un webhook sconosciuto, uno di un’altra applicazione e un segreto errato rispondono tutti con lo stesso 401. Il corpo raw, massimo 1 MiB, diventa il valore della chiave del webhook, e l’header Content-Type il suo content_type (application/octet-stream se assente; un header che non è un tipo media è invalid_request).

La scrittura è PUT /api/applications/{application_id}/kv/{key} senza If-Match: sostituisce il valore, incrementa la revisione, è conteggiata e controllata per quota come ogni scrittura K/V, è una richiesta API fatturata che non viene mai rifiutata per il saldo, e aggiunge kv.updated.

Idempotency-Key (da 8 a 200 caratteri) deduplica i nuovi tentativi di invio di una scrittura per ventiquattro ore, e la stessa chiave con un corpo o tipo di contenuto diverso è idempotency_mismatch; senza di essa ogni invio è una nuova scrittura. La risposta contiene i nuovi metadati della chiave, mai il suo valore.

Al massimo 120 scritture al minuto per webhook; ciascuna conta anche nei limiti di scrittura dell’organizzazione e della chiave (PUT /api/card-data/{key}).