앵귈라(+1 264) 인증 코드: 체크리스트, API 단계, 문제 해결

사전 점검 체크리스트: 첫 앵귈라 주문 전에 무엇을 준비해야 하나요?

이 목록을 한 번 확인하고 나면 첫 실전 테스트가 대개 깔끔하게 끝납니다.

• API 키. 개발자 콘솔에서 만드세요. 키는 or_live_ 접두사를 가지며 계정당 최대 10개까지 둘 수 있으므로 스테이징과 CI에 각각 따로 지급하세요.
• 지갑 잔액. 테스트 스위트 맨 앞에서 GET /api/v1/balance를 호출하면 실행이 중간쯤에서가 아니라 처음부터 실패해 빨리 알 수 있습니다.
• 올바른 국가 ID. 앵귈라는 API에서 ai입니다. 이 두 글자 코드는 설정 파일의 다른 "AI" 라벨과 혼동하기 쉬우니 이름이 붙은 상수로 관리하세요.
• 서비스 ID. 슬러그를 추측하지 말고 GET /api/v1/services에서 가져오세요.
• 웹훅 엔드포인트(선택). 콘솔에 등록하고 시크릿을 저장한 뒤, 핸들러가 대기 중인 테스트를 어떻게 찾을지 정하세요.
• 미국 외 지역의 +1을 받아들이는 전화번호 입력란. 팀들이 가장 늦게 발견하는 항목이며, 이유는 다음 섹션에서 설명합니다.

아무것도 쓰지 않고 전체를 연결해 보고 싶다면 지원팀에 요청해 개발 계정을 샌드박스로 전환하세요. 시뮬레이션된 번호와 코드가 반환됩니다.

+1 264 번호가 전화번호 검증에서 오류를 일으키는 이유는 무엇인가요?

앵귈라는 북미 번호 체계(NANP)에 속하므로 번호가 미국, 캐나다, 그리고 여러 카리브 지역과 같은 +1 국가 코드를 공유합니다. 섬을 식별하는 것은 지역 번호 264입니다. 앵귈라 번호는 +1, 264, 그리고 7자리로 이루어지며, 더하기 1 뒤로 총 10자리입니다. NANP 내에서 국내 트렁크 접두사는 1이므로 같은 회선이 현지 자료에는 1-264-xxx-xxxx로 적히기도 합니다.

이렇게 국가 코드를 공유하면 흔한 버그가 생깁니다.

• 모든 +1 번호를 미국으로 취급하고 미국 주에 매핑하려는 입력 양식
• +1로 시작하는 번호를 모두 "US"로 저장해 분석과 SMS 정책 조회를 왜곡하는 국가 선택기
• 알 수 없는 지역 번호를 거부하는 검증기

번호는 E.164 형식으로 +1264 뒤에 7자리 가입자 번호를 붙여 저장하고, 국가 코드만으로 판단하지 말고 유지 관리되는 번호 라이브러리로 전체 접두사에서 지역을 도출하세요. 공식 언어는 영어이므로 이 경로의 인증 문자는 대체로 서비스의 영어 템플릿으로 도착하며, 코드 추출이 단순해집니다. 팀이 이곳을 테스트하는 경우는 동카리브 지역에 출시할 때, 관광과 숙박 고객을 상대할 때, 또는 NANP 처리가 50개 주 밖에서도 동작하는지 확인하고 싶을 때입니다.

단계별 안내: API로 앵귈라 번호 주문하기

모든 호출은 Bearer 헤더에 키를 담아 https://otproute.com/api/v1로 보냅니다.

1. GET /api/v1/countries로 경로를 확인하고 응답을 하루 동안 캐시합니다.
2. 실시간 가격을 요청합니다. GET /api/v1/prices?country=ai&service=<id>. 가격과 재고는 하루 중 변하므로 하드코딩하지 말고 실행마다 조회하세요.
3. POST /api/v1/activations에 본문 {"service": "<id>", "country": "ai"}를 보내 활성화를 생성합니다. 응답에는 활성화 ID와 +1 264 번호가 들어 있습니다.
4. 테스트 중인 제품의 가입 또는 로그인 화면에 번호를 입력합니다.
5. 웹훅에서 activation.sms_received를 기다리거나 몇 초마다 GET /api/v1/activations/{id}를 폴링합니다. 분당 300건 요청 한도라면 여유가 충분합니다.
6. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel로 주문을 해제해 보류된 금액이 지갑으로 돌아가게 하세요.

전체 요청 및 응답 참조는 API 문서에 있습니다.

앵귈라 경로에서는 어떤 서비스가 코드를 받을 수 있나요?

앵귈라 경로에는 현재 600개가 넘는 서비스가 있습니다. 오늘 스냅샷에서 인기 있는 서비스는 WhatsApp, Telegram, Google(Gmail 및 YouTube), Facebook, Instagram, TikTok, X(Twitter), ChatGPT(OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Uber, Airbnb 등입니다. 섬을 찾는 방문객을 대상으로 하는 팀에게는 여행과 차량 호출 앱이 중요한 경우가 많습니다.

이 목록은 약속이 아니라 출발점으로 보세요. 어떤 OTP 라우팅 네트워크든 재고는 하루 중에도 바뀌며, 그래서 가격 엔드포인트가 국가와 서비스 조합마다 실시간 이용 가능 여부를 알려 줍니다.

개발자가 아닌 사람은 대시보드에서 같은 테스트를 어떻게 하나요?

기획자와 지원 담당자에게 API는 필요하지 않습니다. 로그인한 뒤 OTP Gateway를 열고 앵귈라와 서비스를 선택하고, 주문 전에 표시된 가격을 확인한 다음 확정하세요. 카운트다운과 함께 번호가 나타납니다. 이를 앱에 붙여 넣으면 SMS가 도착했을 때 같은 화면에 코드가 표시됩니다. 계획이 바뀌면 주문 옆의 취소 버튼을 쓰면 됩니다. 반복 가능한 회귀 테스트가 필요하다면 QA 테스트 가이드에서 팀들이 수동 점검과 자동 점검을 어떻게 나누는지 볼 수 있습니다.

문제 해결: 앵귈라 코드가 도착하지 않았어요

티켓을 열기 전에 아래를 차례로 확인하세요.

• 시간 창이 끝날 때까지 기다리세요. 활성화는 20분 동안 열려 있습니다. 첫 번째 주문 1분 뒤에 두 번째 번호를 주문하면 주의만 분산됩니다.
• 수락 여부를 확인하세요. 일부 서비스는 가상 번호를 거부하거나 새 번호에 자체 위험 규칙을 적용합니다. 가입 양식이 번호를 곧바로 거부하면 취소하고 다른 경로를 선택하세요.
• 나중에 다시 시도하거나 경로를 바꾸세요. 작은 섬 경로는 재고가 바뀌므로, 나중에 다시 시도하거나 같은 흐름을 다른 국가에서 테스트하면 해결되는 경우가 많습니다.
• 짧은 간격의 반복 주문을 피하세요. 루프로 계속 다시 주문하면 요청 한도를 소모하고 대상 서비스가 오히려 더 의심하게 만들 수 있습니다.
• 웹훅을 확인하세요. 핸들러가 X-OTPRoute-Signature를 검증하고 성공을 반환하는지 확인하세요. HMAC 검증 가이드에서 상수 시간 비교와 타임스탬프 확인을 다룹니다.

원인이 무엇이든 도착하지 않은 코드에는 비용이 들지 않습니다. 시간 창이 빈 채로 끝나거나 직접 취소하면 전체 금액이 지갑으로 자동 환불됩니다.

장기 회선, 지갑, 인보이스

앵귈라는 +1로 전화를 걸지만 전용 번호(Dedicated Numbers) 상품에는 포함되지 않습니다. 셀프서비스 장기 회선은 미국과 캐나다에서만 제공되며 월 $1.95부터 시작하고, 수신 SMS, 웹훅 전달, 브라우저 통화를 지원합니다. 가상 번호를 참고하세요. 앵귈라의 지속적인 회선이 필요하면 [email protected]으로 이메일을 보내 주세요. 가능 여부는 현지 규정에 따라 달라집니다.

결제는 월 요금도, 선택할 요금제도 없는 선불 USD 지갑 하나로 이루어집니다. 카드 또는 USDT/USDC로 충전하며, 충전할 때마다 PDF 인보이스가 이메일로 도착합니다. 현재 가격은 가격 페이지에 있습니다. OTP Route는 본인의 제품과 계정을 테스트하고 운영하기 위한 서비스이며, 각 서비스의 약관과 OTP Route 이용 정책(Acceptable Use Policy)을 따라야 합니다.

자주 묻는 질문

현지 SIM 없이 내 앱의 앵귈라 가입 흐름을 테스트할 수 있나요?

예. OTP Gateway에서 일회용 +1 264 번호를 주문해 앱에 입력하고, 대시보드나 API로 코드를 확인하면 됩니다.

OTP Route API는 앵귈라에 어떤 국가 ID를 사용하나요?

앵귈라는 ai입니다. 가격 및 활성화 요청에서 country 값으로 전달하세요.

+1 264 번호는 미국 번호로 취급되나요?

그렇게 취급하면 안 됩니다. +1 코드를 공유하지만 지역 번호 264는 앵귈라에 속하므로, 지역 판별은 전체 접두사를 기준으로 해야 합니다.

앵귈라 인증 코드는 비용이 얼마인가요?

코드당 $0.20부터 시작합니다. 정확한 금액은 서비스에 따라 다르며, 주문 전에 대시보드와 가격 엔드포인트에서 확인할 수 있습니다.

번호로 SMS가 도착하지 않으면 어떻게 되나요?

아무것도 청구되지 않습니다. 코드 없이 20분 시간 창이 끝나거나 그 전에 취소하면 전체 금액이 지갑으로 돌아갑니다.

앞으로의 로그인을 위해 앵귈라 번호를 유지할 수 있나요?

셀프서비스로는 불가능합니다. 장기 번호는 미국과 캐나다 전용 상품이며, 그 밖의 지역은 팀에 이메일로 문의해 주세요.

지갑에 충전하기 전에 앵귈라 테스트를 미리 구성해 볼 수 있나요?

예. 요청하면 개발 계정을 샌드박스로 전환해 드리며, 시뮬레이션된 번호와 코드로 처음부터 끝까지 테스트할 수 있습니다.

서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.