get_hook_credits
Get Hook Credits
Read remaining purchased admission credits for an existing hook using its management token. Free and read-only; does not purchase credits. Use purchase_hook_credits to request a quote. The daily free allowance remains separate.
输入参数hookId必填managementToken必填
purchase_hook_credits
Purchase Hook Credits
Request an x402 quote without payment, or buy credits with an explicitly authorized signed payment. Reuse purchaseId and the same payment after any timeout.
输入参数hookId必填paymentpurchaseId必填managementToken必填
register_destination
Register Destination
Register an HTTPS receiver you control. Returns hookId, private credentials and the ownership challenge; delivery remains inactive. Publish the exact challenge on your origin, then call verify_destination. Keep recoveryKey secret and reuse it with the identical target after interruption; do not register again with a new key.
输入参数target必填recoveryKey必填
verify_destination
Verify Destination
Fetch the ownership challenge from the previously registered receiver and activate it when valid. First publish the exact challenge returned by register_destination. Requires the management token; does not deliver an event. Use get_destination_status to inspect progress without activation.
输入参数hookId必填managementToken必填
get_destination_status
Get Destination Status
Read the existing hook ownership challenge and verification or revocation status using its management token. No activation or delivery. Use after registration or an interrupted verification; use get_hook_delivery for one accepted event.
输入参数hookId必填managementToken必填
revoke_destination
Revoke Destination
Permanently revoke this hook with its management token after explicit owner approval. New submissions are rejected; previously accepted deliveries finish. This does not cancel queued events and cannot be undone. Use get_destination_status first if you only need to inspect access.
输入参数hookId必填managementToken必填
accept_hook_event
Accept Hook Event
Enqueue up to 65536 payload bytes for a previously verified receiver using its delivery token. Returns a deliveryId, not proof of delivery. Reuse eventId and exact bytes on retries, then poll get_hook_delivery. The free allowance is 100 events/day per verified receiver; extra admissions consume purchased credits. No arbitrary destination can be supplied here.
输入参数token必填hookId必填eventId必填bodyBase64必填contentType必填
get_hook_delivery
Get Hook Delivery
Read one accepted event by its returned deliveryId and hook delivery token. Poll after accept_hook_event to distinguish queued, retried and completed delivery. Signed observations attest relay attempts, not successful business processing by the receiver. No new delivery or payment.
输入参数token必填hookId必填deliveryId必填
verify_hook_receipt
Verify Hook Receipt
Check an unchanged event and signed receipt returned by get_hook_delivery within the authenticated hook. Requires the delivery token; does not send an event. A valid signature attests relay observations, not business truth or exactly-once processing.
输入参数event必填token必填hookId必填receipt必填