관리번호 발급 링크 단건 조회

GET

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

GET

/v1/accounts/:accountId/assignment-links/:linkId

$ curl https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/assignment-links/LK1a2b3c4d5e \
>      -H "Authorization: Bearer <token>"

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

특정 링크의 상세 정보를 조회합니다. 소비된 링크는 발급된 번호 정보를 함께 반환합니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

linkIdstringRequired

링크 ID (생성 시 반환된 token과 동일)

Response

링크 상세

linkIdstringOptional

urlstringOptional

엔드유저가 방문하여 번호를 발급받을 수 있는 공개 URL

statusenumOptional

createdAtdatetimeOptional

expiresAtdatetimeOptional

consumedAtdatetime or nullOptional

webhookUrlstring or nullOptional

webhookMethodenum or nullOptional

notestring or nullOptional

webhookHeadersmap from strings to strings or nullOptional

발급 시 phone_number 로 prefill 될 헤더. 키는 “X-” prefix 필수 (case-insensitive), reserved 헤더(X-Signature, X-Forwarded-*, X-Real-IP) 거절. 최대 10 entries, key ≤ 64 bytes, value ≤ 2048 bytes, ASCII printable.

assignmentobjectOptional

링크가 소비되어 발급된 번호 정보 (consumed 상태일 때만)

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error