기타
연결음 음원 목록 조회
계정의 연결음 음원 보관함을 조회합니다. 각 항목의 usage 는 그 음원을 쓰는 번호 수입니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
Query Parameters
page?integer
페이지 번호(0-based)
Default
0pageSize?integer
페이지 크기(최대 100)
Default
20Range
value <= 100page_size?integerDeprecated
pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.
Range
value <= 100limit?integerDeprecated
pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.
Range
value <= 100Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/ringback-audios?page=0&pageSize=20&page_size=50&limit=100"{
"data": [
{
"id": "cmh8ra0x10000abcd1234efgh",
"name": "영업시간 안내",
"durationMs": 8400,
"sizeBytes": 134400,
"createdAt": "2026-11-11T02:10:00.000Z",
"usage": {
"signature": 0,
"audio": 2
}
}
],
"meta": {
"page": 0,
"pageSize": 0,
"total": 0
}
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"processedAt": "2026-10-21T04:10:34.303Z",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
],
"numbers": [
"07012345678"
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"processedAt": "2026-10-21T04:10:34.303Z",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
],
"numbers": [
"07012345678"
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"processedAt": "2026-10-21T04:10:34.303Z",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
],
"numbers": [
"07012345678"
]
}