관리번호 발급 링크 목록 조회

GET

https://api.claw-ops.com/v1/accounts/:accountId/assignment-links

GET

/v1/accounts/:accountId/assignment-links

$ curl -G https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/assignment-links \
>      -H "Authorization: Bearer <token>" \
>      -d limit=100 \
>      -d page=0 \
>      -d pageSize=20 \
>      -d page_size=50 \
>      -d status=pending

1 {
2   "data": [
3     {
4       "linkId": "FUjxM9qBBy_EIZp7QizzWSqXyUqqmrsnviw7PLdDI5w",
5       "url": "https://platform.claw-ops.com/assign/FUjxM9qBBy_EIZp7QizzWSqXyUqqmrsnviw7PLdDI5w",
6       "status": "pending",
7       "createdAt": "2024-01-15T09:30:00Z",
8       "expiresAt": "2024-01-15T09:30:00Z",
9       "consumedAt": "2024-01-15T09:30:00Z",
10       "webhookUrl": "string",
11       "webhookMethod": "POST",
12       "note": "string",
13       "webhookHeaders": {
14         "X-Webhook-Token": "tenant-secret-abc123"
15       },
16       "assignment": {
17         "number": "07012340001",
18         "name": "홍길동",
19         "consumedAt": "2024-01-15T09:30:00Z",
20         "releasedAt": "2024-01-15T09:30:00Z"
21       }
22     }
23   ],
24   "meta": {
25     "page": 1,
26     "pageSize": 1,
27     "total": 1
28   }
29 }

계정의 발급 링크 목록을 페이지네이션으로 조회합니다. external_assignment 애드온 활성 여부와 무관하게 조회 가능합니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Query parameters

statusenumOptional

링크 상태로 필터링

Allowed values:

pageSizeintegerOptional<=100Defaults to 20

페이지당 항목 수 (1~100, 기본 20)

page_sizeintegerOptional<=100Deprecated

pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.

limitintegerOptional<=100Deprecated

pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.

pageintegerOptionalDefaults to 0

페이지 번호 (0부터 시작)

Response

링크 목록

datalist of objectsOptional

metaobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error