발신번호 조회

센드온 SDK는 사용자의 발신번호 정보를 간편하게 조회할 수 있는 기능을 제공합니다.
이 섹션에서는 발신번호 조회 방법과 예제를 다룹니다.


발신번호 조회

발신번호 리스트를 조회하여 사용 가능한 발신번호를 확인할 수 있습니다.

Node.js 예제

import { Sendon } from '@alipeople/sendon-sdk-typescript'
import { ListUserNumbersResponseDto } from '@alipeople/sendon-sdk-typescript';

const sendon = new Sendon({ id: "YOUR_ID", apikey: "YOUR_APIKEY" })

const result1: ListUserNumbersResponseDto = await sendon.sender.listUserNumbers()

발신번호 조회 응답 예제

{
  "code": 200,
  "message": "OK",
  "data": {
    "list": [
      {
        "numberId": 0,
        "senderNumber": "YOUR_SENDER_NUMBER",
        "numberType": "MOBILE",
        "senderStatus": "ACTIVE",
        "isDefault": "Y",
        "displayName": "DISPLAY_NAME_FOR_YOUR_SENDER_NUMBER",
        "companyName": "YOUR_COMPANY_NAME",
        "createdAt": "2025-03-12T08:55:59.430Z",
        "updatedAt": "2025-03-12T08:55:59.430Z"
      }
    ],
    "cursor": 0
  }
}

발신번호 응답 필드 설명

필드설명필수 여부
numberId발신번호 고유 ID필수
senderNumber발신번호 (전화번호)필수
numberType발신번호 유형 (MOBILE, LANDLINE)필수
senderStatus발신번호 인증 상태 (ACTIVE = 정상)필수
isDefault기본 발신번호 여부 (Y 또는 N)필수
displayName발신번호 표시명 (별칭)필수
companyName회사명필수
createdAt발신번호 등록 일시 (ISO 8601 형식)필수
updatedAt발신번호 최근 업데이트 일시 (ISO 8601 형식)필수

자세한 코드 예제는 아래 문서를 참고하세요.

🔗 SDK 발신번호 조회 가이드