토큰 정보 API

Tier: Free, Premium, Ultimate Offering: Self-managed
Status: Experiment

이 기능의 사용 가능성은 기능 플래그에 의해 제어됩니다.
자세한 내용은 이력서를 참조하십시오.
이 기능은 테스트를 위해 제공되지만, 프로덕션 사용을 위한 준비가 되어 있지 않습니다.

관리자는 이 API를 사용하여 임의의 토큰에 대한 정보를 검색할 수 있습니다. 다른 API 엔드포인트가 토큰 정보를 노출하는 것과 달리, 개인 액세스 토큰 API는 관리자가 토큰의 유형을 알지 못하고도 토큰 정보를 검색할 수 있도록 합니다.

필수 조건:

  • 관리자가 되어야 합니다.

토큰 정보 가져오기

토큰에 대한 정보를 반환합니다.

지원하는 토큰:

POST /api/v4/admin/token

지원하는 속성:

속성 유형 필수 설명
token string 예 식별해야 하는 토큰입니다.

성공적일 경우, 200 및 토큰에 대한 정보를 반환합니다.

다음 상태 코드를 반환할 수 있습니다:

  • 200 OK: 토큰에 대한 정보입니다.
  • 401 Unauthorized: 사용자가 권한이 없습니다.
  • 403 Forbidden: 사용자가 관리자가 아닙니다.
  • 404 Not Found: 토큰을 찾을 수 없습니다.
  • 422 Unprocessable: 토큰 유형이 지원되지 않습니다.

예제 요청:

curl --request POST \
  --url "https://gitlab.example.com/api/v4/admin/token" \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header 'Content-Type: application/json' \
  --data '{"token": "glpat-<example-token>"}'

예제 응답:

{
 "id": 1,
 "user_id": 70,
 "name": "project-access-token",
 "revoked": false,
 "expires_at": "2024-10-04",
 "created_at": "2024-09-04T07:19:18.652Z",
 "updated_at": "2024-09-04T07:19:18.652Z",
 "scopes": [
  "api",
  "read_api"
 ],
 "impersonation": false,
 "expire_notification_delivered": false,
 "last_used_at": null,
 "after_expiry_notification_delivered": false,
 "previous_personal_access_token_id": null,
 "advanced_scopes": null,
 "organization_id": 1
}