board-github

POST `/v1/board-github/webhook/{endpointKey}`

One GitHub webhook delivery for a linked project.

Autentizace

Tento koncový bod je veřejný. Nevyžaduje žádná pověření ani organizaci – je to to, co čte náš vlastní marketingový web a naše AI vyhledávače.

Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.

Vyzvednout

Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.

curl -X POST https://api.zinndigital.com/v1/board-github/webhook/{endpointKey}

Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API

Podrobnosti

Public and unauthenticated — the HMAC is the authentication. GitHub cannot present a session, so X-Hub-Signature-256 over the raw body with this connection's own secret is the whole control. Answers 202 for every valid delivery, including ones we do not act on — a ping, or an event type we ignore. Answering those with an error paints the endpoint permanently red on the customer's own GitHub screen, so a working integration looks broken; the reason field says which. A bad or absent signature is 401 with an empty body: a response that distinguished "no such endpoint" from "wrong secret" would be an oracle for guessing endpoint keys.

Parametry

Název	Typ	Požadováno	Co to je
`endpointKey (path)`	`string`	Ano	The connection's opaque endpoint key, or `app` for the platform GitHub App's own shared webhook. Not the connection's id — a URL the customer pastes into GitHub ends up in their…

Odpověď

Název	Typ	Požadováno	Co to je
`accepted`	`boolean`	Ano	—
`reason`	`string`	Ne	Why a valid delivery was not acted on (`ping`, an unhandled event, an unlinked project).
`link_id`	`string`	Ne	—
`queued`	`boolean`	Ne	—

Chyby, které může tento koncový bod vrátit

401

POST /v1/board-github/webhook/{endpointKey}