Project (classic) 열에 대한 REST API 엔드포인트
REST API를 사용하여 프로젝트(클래식)에서 열을 만들고 관리합니다.
참고:
- 이러한 엔드포인트는 projects (classic)와만 상호 작용합니다. Projects을(를) 관리하려면 GraphQL API를 사용합니다. 자세한 내용은 "API를 사용하여 Projects 관리.
- 새 프로젝트(클래식)을(를) 만들려면 조직, 사용자 또는 리포지토리에 이미 하나 이상의 프로젝트(클래식)이(가) 있어야 합니다.
projects (classic)을(를) 관리하는 REST API는 personal access token (classic)을(를) 사용하는 인증만 지원합니다. 자세한 내용은 "개인용 액세스 토큰 관리"을 참조하세요.
Get a project column
Gets information about a project column.
"Get a project column"에 대한 세분화된 액세스 토큰
이 엔드포인트는 다음 토큰 형식에서 작동합니다.:
토큰에 다음 권한 집합 중 하나 이상이 있어야 합니다.:
repository_projects:read
organization_projects:read
공용 리소스만 요청되는 경우 인증 또는 앞서 언급한 권한 없이 이 엔드포인트를 사용할 수 있습니다.
"Get a project column"에 대한 매개 변수
이름, Type, 설명 |
---|
accept string Setting to |
이름, Type, 설명 |
---|
column_id integer RequiredThe unique identifier of the column. |
"Get a project column"에 대한 HTTP 응답 상태 코드
상태 코드 | 설명 |
---|---|
200 | OK |
304 | Not modified |
401 | Requires authentication |
403 | Forbidden |
404 | Resource not found |
"Get a project column"에 대한 코드 샘플
요청 예제
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/projects/columns/COLUMN_ID
Response
Status: 200
{
"url": "https://api.github.com/projects/columns/367",
"project_url": "https://api.github.com/projects/120",
"cards_url": "https://api.github.com/projects/columns/367/cards",
"id": 367,
"node_id": "MDEzOlByb2plY3RDb2x1bW4zNjc=",
"name": "To Do",
"created_at": "2016-09-05T14:18:44Z",
"updated_at": "2016-09-05T14:22:28Z"
}
Update an existing project column
"Update an existing project column"에 대한 세분화된 액세스 토큰
이 엔드포인트는 다음 토큰 형식에서 작동합니다.:
토큰에 다음 권한 집합 중 하나 이상이 있어야 합니다.:
repository_projects:write
organization_projects:write
"Update an existing project column"에 대한 매개 변수
이름, Type, 설명 |
---|
accept string Setting to |
이름, Type, 설명 |
---|
column_id integer RequiredThe unique identifier of the column. |
이름, Type, 설명 |
---|
name string RequiredName of the project column |
"Update an existing project column"에 대한 HTTP 응답 상태 코드
상태 코드 | 설명 |
---|---|
200 | OK |
304 | Not modified |
401 | Requires authentication |
403 | Forbidden |
"Update an existing project column"에 대한 코드 샘플
요청 예제
curl -L \
-X PATCH \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/projects/columns/COLUMN_ID \
-d '{"name":"To Do"}'
Response
Status: 200
{
"url": "https://api.github.com/projects/columns/367",
"project_url": "https://api.github.com/projects/120",
"cards_url": "https://api.github.com/projects/columns/367/cards",
"id": 367,
"node_id": "MDEzOlByb2plY3RDb2x1bW4zNjc=",
"name": "To Do",
"created_at": "2016-09-05T14:18:44Z",
"updated_at": "2016-09-05T14:22:28Z"
}
Delete a project column
Deletes a project column.
"Delete a project column"에 대한 세분화된 액세스 토큰
이 엔드포인트는 다음 토큰 형식에서 작동합니다.:
토큰에 다음 권한 집합 중 하나 이상이 있어야 합니다.:
repository_projects:write
organization_projects:write
"Delete a project column"에 대한 매개 변수
이름, Type, 설명 |
---|
accept string Setting to |
이름, Type, 설명 |
---|
column_id integer RequiredThe unique identifier of the column. |
"Delete a project column"에 대한 HTTP 응답 상태 코드
상태 코드 | 설명 |
---|---|
204 | No Content |
304 | Not modified |
401 | Requires authentication |
403 | Forbidden |
"Delete a project column"에 대한 코드 샘플
요청 예제
curl -L \
-X DELETE \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/projects/columns/COLUMN_ID
Response
Status: 204
Move a project column
"Move a project column"에 대한 세분화된 액세스 토큰
이 엔드포인트는 다음 토큰 형식에서 작동합니다.:
토큰에 다음 권한 집합 중 하나 이상이 있어야 합니다.:
repository_projects:write
organization_projects:write
"Move a project column"에 대한 매개 변수
이름, Type, 설명 |
---|
accept string Setting to |
이름, Type, 설명 |
---|
column_id integer RequiredThe unique identifier of the column. |
이름, Type, 설명 |
---|
position string RequiredThe position of the column in a project. Can be one of: |
"Move a project column"에 대한 HTTP 응답 상태 코드
상태 코드 | 설명 |
---|---|
201 | Created |
304 | Not modified |
401 | Requires authentication |
403 | Forbidden |
422 | Validation failed, or the endpoint has been spammed. |
"Move a project column"에 대한 코드 샘플
요청 예제
curl -L \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/projects/columns/COLUMN_ID/moves \
-d '{"position":"last"}'
Response
List project columns
Lists the project columns in a project.
"List project columns"에 대한 세분화된 액세스 토큰
이 엔드포인트는 다음 토큰 형식에서 작동합니다.:
토큰에 다음 권한 집합 중 하나 이상이 있어야 합니다.:
repository_projects:read
organization_projects:read
공용 리소스만 요청되는 경우 인증 또는 앞서 언급한 권한 없이 이 엔드포인트를 사용할 수 있습니다.
"List project columns"에 대한 매개 변수
이름, Type, 설명 |
---|
accept string Setting to |
이름, Type, 설명 |
---|
project_id integer RequiredThe unique identifier of the project. |
이름, Type, 설명 |
---|
per_page integer The number of results per page (max 100). For more information, see "Using pagination in the REST API." 기본값: |
page integer The page number of the results to fetch. For more information, see "Using pagination in the REST API." 기본값: |
"List project columns"에 대한 HTTP 응답 상태 코드
상태 코드 | 설명 |
---|---|
200 | OK |
304 | Not modified |
401 | Requires authentication |
403 | Forbidden |
"List project columns"에 대한 코드 샘플
요청 예제
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/projects/PROJECT_ID/columns
Response
Status: 200
[
{
"url": "https://api.github.com/projects/columns/367",
"project_url": "https://api.github.com/projects/120",
"cards_url": "https://api.github.com/projects/columns/367/cards",
"id": 367,
"node_id": "MDEzOlByb2plY3RDb2x1bW4zNjc=",
"name": "To Do",
"created_at": "2016-09-05T14:18:44Z",
"updated_at": "2016-09-05T14:22:28Z"
}
]
Create a project column
Creates a new project column.
"Create a project column"에 대한 세분화된 액세스 토큰
이 엔드포인트는 다음 토큰 형식에서 작동합니다.:
토큰에 다음 권한 집합 중 하나 이상이 있어야 합니다.:
repository_projects:write
organization_projects:write
"Create a project column"에 대한 매개 변수
이름, Type, 설명 |
---|
accept string Setting to |
이름, Type, 설명 |
---|
project_id integer RequiredThe unique identifier of the project. |
이름, Type, 설명 |
---|
name string RequiredName of the project column |
"Create a project column"에 대한 HTTP 응답 상태 코드
상태 코드 | 설명 |
---|---|
201 | Created |
304 | Not modified |
401 | Requires authentication |
403 | Forbidden |
422 | Validation failed, or the endpoint has been spammed. |
"Create a project column"에 대한 코드 샘플
요청 예제
curl -L \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/projects/PROJECT_ID/columns \
-d '{"name":"Remaining tasks"}'
Response
Status: 201
{
"url": "https://api.github.com/projects/columns/367",
"project_url": "https://api.github.com/projects/120",
"cards_url": "https://api.github.com/projects/columns/367/cards",
"id": 367,
"node_id": "MDEzOlByb2plY3RDb2x1bW4zNjc=",
"name": "To Do",
"created_at": "2016-09-05T14:18:44Z",
"updated_at": "2016-09-05T14:22:28Z"
}