개발자 API 참조 문서

간단한 HTTP GET 요청으로 테스트 전화번호를 프로그래밍 방식으로 일괄 생성합니다.

API 엔드포인트

다음 URL로 HTTP GET 요청을 보내세요:

GEThttps://phone-number.loveyouall.qzz.io/api/generate

온라인 테스트 (Try It)

아래에서 파라미터를 입력하고 실제 API를 직접 호출하여 JSON 응답을 확인하세요.

파라미터: country

quantity

safetyMode

region

city

쿼리 파라미터

파라미터	타입	필수 여부	설명
`country`	string	아니요	국가 코드. "US", "CN", "CA", "GB", "AU", "DE", "FR", "JP", "KR", "IN", "SG", "ES", "IT", "BR", "MX", "RU", "NL" 지원. 기본값 "US".
`region`	string	아니요	지역/주/통신사 이름(예: "California", "Ontario", "중국이동"). 대소문자 구분 안 함.
`city`	string	아니요	도시 이름 또는 3자리/2자리 특정 프리픽스(예: "Los Angeles", "138"). 대소문자 구분 안 함. region 지정 필요.
`quantity`	integer	아니요	생성할 번호 개수. 범위: 1–1000(1000 초과 시 잘림). 기본값: 10.
`customPrefix`	string	아니요	사용자 지정 프리픽스 숫자(0-9 숫자만). 선택 사항.
`safetyMode`	string	아니요	안전 모드. "realistic"(실제 규칙)과 "safe"(공식 예약 가상 테스트 번호, 예: 555-XXXX) 지원. 기본값 "realistic".
`uniqueOnly`	boolean	아니요	고유 번호만 생성할지 여부. "true" 또는 "false" 지원. 기본값 "true".

코드 통합 예제

선호하는 언어나 도구를 선택하여 생성 API를 통합하세요:

curl -X GET "https://phone-number.loveyouall.qzz.io/api/generate?country=US&quantity=5&safetyMode=safe&uniqueOnly=true"

응답 형식

전화번호 레코드 객체의 JSON 배열을 반환합니다. 각 객체에는 로컬라이즈 필드, 표시 형식, 표준 E.164 문자열이 포함됩니다.

[
  {
    "id": "c852d129-4112-4981-8ddb",
    "country": "US",
    "region": "California",
    "regionCode": "CA",
    "city": "Los Angeles",
    "areaCode": "213",
    "display": "+1 (213) 932-8419",
    "e164": "+12139328419"
  }
]

응답 필드 설명

필드	타입	설명
`id`	string	레코드의 고유 UUID v4 식별자.
`country`	string	두 글자 국가 코드(예: US, CN).
`region`	string	주 / 도 / 통신사 이름, 예: California, 중국이동.
`regionCode`	string	존재 시 주/도 두 글자 코드, 예: CA(캘리포니아).
`areaCode`	string	지역번호 또는 프리픽스, 예: 213, 138.
`city`	string	도시 이름 또는 번호 구간, 예: Los Angeles, 138.
`display`	string	사람이 읽기 쉬운 형식의 번호, 예: +1 (213) 555-1234.
`e164`	string	표준 E.164 형식, 예: +12135551234.

오류 코드

API는 표준 HTTP 상태 코드를 사용하며 실패 시 항상 "error" 필드가 포함된 JSON을 반환합니다.

상태 코드	발생 조건	응답 본문
`400`	지원되지 않는 국가 코드	`{"error":"Unsupported country code: XX"}`
`400`	선택한 국가에 존재하지 않는 주/도 또는 도시	`{"error":"Unknown region ... for country US"}`
`400`	customPrefix에 숫자가 아닌 문자가 포함됨	`{"error":"customPrefix must contain digits only"}`
`400`	region 없이 city 전달됨	`{"error":"city requires region"}`
`500`	생성 중 내부 오류 발생	`{"error":"Internal Server Error"}`

사용 제한

무료·인증 불필요, API 키 필요 없음
요청당 최대 1000개(초과분은 잘림)
기본값: country=US, quantity=10, safetyMode=realistic, uniqueOnly=true
safetyMode=safe는 공식 예약 가상 테스트 번호(예: 555-XXXX)를 사용하므로 실제 사용자에게 연결되지 않음