Listar Chaves Públicas de Webhook

curl --request GET \ --url https://conta-public-api.kiwify.com/v1/webhooks-keys \ --header 'X-PoP-Challenge: <api-key>' \ --header 'X-PoP-Format: <api-key>' \ --header 'X-PoP-Signature: <api-key>' \ --header 'x-access-id: <api-key>'

{ "public_keys": [ { "algorithm": "EdDSA-Ed25519", "content": "-----BEGIN PUBLIC KEY-----\nMFYwEAYHKoZIzj0CAQYFK4EEAAoDQgAEQA+bOEY57yQGYdcF0q7Ia/JPc0Hr8Il0\n/pbETwvDSM+7yCkqTPDRsdptMMaoK9UEXILOaXq9Ot5azrgQEcTetg==\n-----END PUBLIC KEY-----", "created_at": "2026-05-28T14:30:00Z", "id": 2, "is_active": true } ], "next_cursor": "<string>" }

Header	Descrição
`Content-Type`	Sempre `application/json`
`x-kiwify-digital-signature`	Assinatura Ed25519 em base64url (sem padding)
`x-kiwify-timestamp`	Timestamp Unix em milissegundos usado na mensagem assinada

Header

Descrição

Content-Type

Sempre application/json

x-kiwify-digital-signature

Assinatura Ed25519 em base64url (sem padding)

x-kiwify-timestamp

Timestamp Unix em milissegundos usado na mensagem assinada

Verificação de Assinatura

Reconstrua a mensagem assinada: {url_path}:POST:{raw_body}:{timestamp}

Calcule o hash SHA-256 dos bytes da mensagem

Verifique a assinatura com a chave pública ativa deste endpoint (EdDSA-Ed25519)

Rejeite timestamps com mais de 5 minutos de diferença

Consulte o guia Headers e Verificação de Webhooks para o passo a passo completo com exemplos de código.

Autorizações

x-access-id

string

header

obrigatório

UUID of the service account (e.g., 550e8400-e29b-41d4-a716-446655440000)

X-PoP-Challenge

string

header

obrigatório

Unix timestamp in milliseconds (e.g., 1704636800000). Must be within 5 minutes of server time.

X-PoP-Format

string

header

obrigatório

Must be 'service-account' for service account authentication

X-PoP-Signature

string

header

obrigatório

EdDSA signature of the request in base64 format. Signs: uri:method:body:timestamp

Parâmetros de consulta

limit

integer<int32> | null

Maximum number of results per page (1-100, default: 20).

Intervalo obrigatório: x >= 0

cursor

string | null

Pagination cursor in format "timestamp_micros:id".

Resposta

List of public keys for webhook signature verification

Response containing the list of webhook public keys.

public_keys

object[]

obrigatório

List of public keys used for webhook signature verification.

Show child attributes

next_cursor

string | null

Cursor for next page (null if no more results).