board-github
GET /v1/board-github/links
The GitHub Projects this organisation has connected.
Autentizace
Odešlete klíč API jako bearer token. Tento koncový bod ve specifikaci uvádí specifické oprávnění, takže svému klíči udělte to nejmenší možné a místo předpokladů zkontrolujte odpověď.
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 GET https://api.zinndigital.com/v1/board-github/links \
-H "Authorization: Bearer zdk_live_…"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
Each row carries webhook_state, which is the honest answer to "is GitHub pushing changes at us, or are we polling?". It has three outcomes and not two: automatic (we created the hook), manual (GitHub would not let us, so the customer creates it and we hand them the URL and secret) and failed. manual is the commonest and is an instruction, not an error — creating an organisation webhook needs a permission most customers will not grant. The five-minute reconciliation sweep covers a project in every state, so this decides latency and never correctness.
Parametry
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
board_id (query) | string | Ne | Only links surfaced alongside this board. |
cursor (query) | string | Ne | Opaque cursor from a previous page's page.next_cursor. |
limit (query) | integer | Ne | Maximum items to return (page size). |
Odpověď
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
data | GitHubProjectLink[] | Ano | — |
page | PageMeta | Ano | — |
Chyby, které může tento koncový bod vrátit
401 · 403