board-github
GET /v1/board-github/links
The GitHub Projects this organisation has connected.
Автентифікація
Надішліть ключ API як маркер носія (bearer token). Ця кінцева точка не вказує конкретного дозволу в специфікації, тому надайте своєму ключу мінімально необхідні права та перевірте відповідь, замість того щоб припускати.
Цей кінцевий пункт не потребує ідентифікатора організації. Ваш ключ уже ідентифікує організацію, якій він належить, і відповідь обмежується її межами.
Спробувати
Замініть усе в кутових дужках власними значеннями, а заповнювач ключа — ключем із вашої панелі керування.
curl -X GET https://api.zinndigital.com/v1/board-github/links \
-H "Authorization: Bearer zdk_live_…"Увійшли в систему? Консоль API у вашій панелі керування автоматично підставляє ваш реальний ідентифікатор організації та ваш власний ключ, а також виконує запит до робочого API, щоб ви могли побачити справжню відповідь. Відкрийте цю кінцеву точку в консолі API
Деталі
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.
Параметри
| Назва | Тип | Обов'язкове | Що це таке |
|---|---|---|---|
board_id (query) | string | Ні | Only links surfaced alongside this board. |
cursor (query) | string | Ні | Opaque cursor from a previous page's page.next_cursor. |
limit (query) | integer | Ні | Maximum items to return (page size). |
Відповідь
| Назва | Тип | Обов'язкове | Що це таке |
|---|---|---|---|
data | GitHubProjectLink[] | Так | — |
page | PageMeta | Так | — |
Помилки, які може повертати ця кінцева точка
401 · 403