board-github

POST /v1/board-github/links/{linkId}/items

Post a new item to the GitHub Project from our UI.

Բոլոր board-github վերջնակետերը

Նույնականացում

Ուղարկեք API բանալին որպես bearer թոքեն։ Այս վերջնակետը բնութագրում չի նշում որոշակի թույլտվության մասին, ուստի տվեք ձեր բանալուն նվազագույն անհրաժեշտը և ենթադրություններ անելու փոխարեն ստուգեք պատասխանը:

Այս վերջնակետը կազմակերպության ID չի ընդունում: Ձեր բանալին արդեն իսկ նույնականացնում է այն կազմակերպությունը, որին պատկանում է, և պատասխանը սահմանափակված է դրանով:

Փորձել

Փոխարինեք անկյունային փակագծերում գտնվող ցանկացած բան ձեր սեփական արժեքներով, և բանալու տեղապահը՝ ձեր վահանակի բանալիով:

curl -X POST https://api.zinndigital.com/v1/board-github/links/{linkId}/items \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "title": <string> }'

Մուտք գործե՞լ եք: Ձեր վահանակի API վահանակը լրացնում է ձեր իրական կազմակերպության ID-ն և ձեր սեփական բանալին և գործարկում է հարցումը ուղիղ API-ի դեմ, որպեսզի կարողանաք տեսնել փաստացի պատասխանը: Բացեք այս վերջնակետը API վահանակում

Մանրամասներ

Creates a draft item on GitHub and sets whatever field values were sent, then **reads the item back from GitHub** rather than assembling the response from our own input. A mutation's echo is our own payload handed back, so building the row from it would make the row agree with our intention whether or not GitHub stored it. A field whose type GitHub's field-value mutation cannot set is skipped rather than refused, and the read-back is what tells the truth about which values landed.

Պարամետրեր

ԱնունՏեսակՊահանջվում էԻնչ է դա
linkId (path)stringԱյոThe GitHub Projects connection.

Հարցման մարմին

ԱնունՏեսակՊահանջվում էԻնչ է դա
titlestringԱյո
bodystringՈչ
field_valuesobjectՈչKeyed by field node id.

Պատասխան

ԱնունՏեսակՊահանջվում էԻնչ է դա
idstringՈչ
item_node_idstringՈչ
item_typestring<ISSUE, PULL_REQUEST, DRAFT_ISSUE, REDACTED>Ոչ
content_numberintegerՈչ
repositorystringՈչ
titlestringՈչ
bodystringՈչ
urlstringՈչ
statestringՈչ
is_archivedbooleanՈչ
field_valuesobjectՈչKeyed by the field's **node id**, never its name. A project owner renaming a field would otherwise orphan every stored value at once, and the next sync would read it as "every i…
github_updated_atstringՈչ
local_updated_atstringՈչWhen WE last changed this item. Set only by a local edit, never by a sync — a sync that stamped it would make every imported item look locally-edited and hand every subsequent c…
card_idstringՈչ

Այս վերջնակետի կողմից վերադարձվող սխալները

401 · 403 · 404 · 422