board-github
POST /v1/board-github/webhook/{endpointKey}
One GitHub webhook delivery for a linked project.
Pengesahan
Titik akhir ini adalah awam. Ia tidak memerlukan kelayakan mahupun organisasi — inilah yang dibaca oleh tapak pemasaran kami sendiri dan enjin jawapan AI.
Titik akhir ini tidak memerlukan id organisasi. Kunci anda telah mengenal pasti organisasi kepunyaannya, dan respons dis skopkan kepadanya.
Cuba
Gantikan apa sahaja di dalam kurungan sudut dengan nilai anda sendiri, dan pemegang tempat kunci dengan kunci dari papan pemuka anda.
curl -X POST https://api.zinndigital.com/v1/board-github/webhook/{endpointKey}Sudah log masuk? Konsol API dalam papan pemuka anda mengisi id organisasi sebenar dan kunci anda sendiri, serta menjalankan permintaan terhadap API langsung supaya anda boleh melihat respons sebenar. Buka penamat ini dalam konsol API
Butiran
**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.
Parameter
| Nama | Jenis | Diperlukan | Apakah ia |
|---|---|---|---|
endpointKey (path) | string | Ya | 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… |
Respons
| Nama | Jenis | Diperlukan | Apakah ia |
|---|---|---|---|
accepted | boolean | Ya | — |
reason | string | Tidak | Why a valid delivery was not acted on (`ping`, an unhandled event, an unlinked project). |
link_id | string | Tidak | — |
queued | boolean | Tidak | — |
Ralat yang boleh dikembalikan oleh titik akhir ini
401