빠른 시작
몇 분 안에 첫 요청을 보내세요.
계정 확인
고객 계정에 가입하고 이메일 주소를 확인하세요.
키 생성
API 키를 만드세요. 평문 값은 한 번만 표시됩니다.
JSON 가져오기
키는 Authorization 헤더의 Bearer Token으로만 보내세요.
Bearer Token
curl "https://vorwahl.app/api/search.php?q=040" \
-H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"
키를 안전하게 전송
API 키를 URL, 브라우저 방문 기록, 프록시 로그 또는 참조 주소에 넣지 마세요. 따라서 쿼리 매개변수로 키를 보내는 방식은 허용되지 않습니다.
엔드포인트
검색, 계정 및 결제를 위한 명확한 JSON 엔드포인트.
GET
/api/search.php
전화 코드, 전화번호, 지역, 국가, 서비스 또는 긴급 번호를 검색합니다.
| 매개변수 | 설명 |
|---|---|
| q | 검색어입니다. 예: 030, Berlin, +44, 0800. |
| limit | 선택 사항이며 결과는 1~50개입니다. 기본값: 12. |
GET
/api/internationalize.php
한 국가의 국내 전화번호를 복사 가능한 국제 형식으로 변환합니다.
| 매개변수 | 설명 |
|---|---|
| number | 국내 번호입니다. 예: 0343 222 1234. |
| country | 번호 국가의 ISO 코드입니다. 예: GB, DE, AT. 기본값: DE. |
curl "https://vorwahl.app/api/internationalize.php?number=0343%20222%201234&country=GB" \
-H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"
{
"ok": true,
"input": "0343 222 1234",
"country": "GB",
"international": "+44 343 222 1234"
}
GET
/api/health.php
상태와 현재 데이터 수를 반환합니다.
GET
/api/billing/plans.php
사용 가능한 API 요금제, 한도 및 PayPal 상태를 반환합니다.
POST
/api/account/api-keys.php
로그인하고 인증된 사용자의 API 키를 만듭니다.
응답 형식
각 결과에는 표시, 검증 및 형식 지정에 필요한 데이터가 있습니다.
code전화 코드 또는 번호 범위입니다. 예: 030 또는 +49.name지역, 국가, 서비스 또는 긴급 서비스 이름.kindOrt, Land, Region, Dienst, Notruf.local_format권장 국내 표시 형식.international_format권장 국제 표시 형식.advice비용, 사용법 또는 전화 거는 방법에 대한 이해하기 쉬운 안내.API 계획
공정한 무료 사용을 제공하는 예측 가능한 월간 할당량.
Das Lizenzangebot richtet sich ausschließlich an Unternehmen. Aufgrund der Kleinunternehmerregelung gemäß § 19 UStG wird keine Umsatzsteuer berechnet.