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

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

{
  "data": [
    {
      "linkId": "FUjxM9qBBy_EIZp7QizzWSqXyUqqmrsnviw7PLdDI5w",
      "url": "https://platform.claw-ops.com/assign/FUjxM9qBBy_EIZp7QizzWSqXyUqqmrsnviw7PLdDI5w",
      "status": "pending",
      "createdAt": "2024-01-15T09:30:00Z",
      "expiresAt": "2024-01-15T09:30:00Z",
      "consumedAt": "2024-01-15T09:30:00Z",
      "webhookUrl": "string",
      "webhookMethod": "POST",
      "note": "string",
      "returnUrl": "string",
      "webhookHeaders": {
        "X-Webhook-Token": "tenant-secret-abc123"
      },
      "assignment": {
        "number": "07012340001",
        "name": "홍길동",
        "consumedAt": "2024-01-15T09:30:00Z",
        "releasedAt": "2024-01-15T09:30:00Z"
      }
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 1,
    "total": 1
  }
}

계정의 발급 링크 목록을 페이지네이션으로 조회합니다. 「관리번호 추가」 활성 여부와 무관하게 조회 가능합니다.

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