API로 예멘(+967) 인증 코드 수집하기

+967 코드까지 가는 가장 짧은 API 경로는 무엇인가요?

클라이언트가 Developer 콘솔에서 발급한 Bearer 키로 https://otproute.com/api/v1을 향하게 하세요. 키에는 or_live_ 접두사가 붙습니다. 예멘의 국가 id는 ye입니다.

1. GET /api/v1/prices?country=ye&service=<id>로 가격을 가져옵니다. 응답은 코드 요금과 경로가 열려 있는지 알려 줍니다.
2. {"service": "whatsapp", "country": "ye"}와 함께 POST /api/v1/activations로 주문을 만듭니다. activation id와 +967 번호가 반환됩니다.
3. 번호를 자사 앱의 인증 단계에 입력하거나 주입합니다.
4. GET /api/v1/activations/{id} 또는 웹훅 이벤트에서 코드를 가져옵니다.
5. 끝나지 않은 주문은 POST /api/v1/activations/{id}/cancel로 해제합니다.

GET /api/v1/services와 GET /api/v1/countries는 거의 바뀌지 않으므로 하루 동안 캐시하세요. 일괄 작업 전에 GET /api/v1/balance를 호출하면 잔액이 부족할 때 작업이 일찍 멈출 수 있습니다. 분당 300회 요청이라는 한도는 계정 단위로 적용되며, 키는 최대 10개까지 발급할 수 있습니다. 이 예멘 OTP API 흐름의 실제 예시는 연동 가이드를 참고하세요.

예멘 활성화의 웹훅 전달은 어떻게 검증하나요?

Developer 콘솔에 HTTPS 엔드포인트를 등록하고(계정당 다섯 개 가능) activation.sms_received를 구독하세요. 작업이 대기를 멈출 시점을 알 수 있도록 activation.expired와 activation.cancelled도 함께 구독합니다.

서명 검증은 하나의 레시피를 따릅니다. X-OTPRoute-Signature를 t와 v1으로 나누고, 엔드포인트 시크릿으로 문자열 <t>.<raw body>의 HMAC-SHA256을 계산한 뒤 결과를 상수 시간 함수로 v1과 비교합니다. 타임스탬프가 허용 범위보다 오래되었다면 요청을 거부하세요. 전달이 재시도될 수 있으므로 핸들러는 멱등하게 만들어야 합니다. activation id를 저장하고 반복은 무시하세요. HMAC으로 OTP 웹훅 보호하기에서 시계 오차 같은 엣지 케이스를 다룹니다.

아랍어 메시지에 대해 파서는 무엇을 예상해야 하나요?

아랍어가 예멘의 공용어이므로 많은 서비스가 주변 문구를 아랍어로 보냅니다. 자사 메시지를 테스트하는 사람에게는 실용적인 영향이 있습니다. 아랍 문자는 UCS-2 인코딩이 필요해 SMS 한 세그먼트가 70자로 제한되고, 오른쪽에서 왼쪽으로 쓰는 텍스트는 알림에서 코드가 나타나는 위치를 바꿀 수 있습니다. 어떤 템플릿은 숫자를 문장 앞에, 어떤 템플릿은 뒤에 둡니다.

주변 단어와 상관없이 연속된 숫자를 찾도록 추출 단계를 작성하세요. 발신자가 아랍-인도 숫자(٠에서 ٩)를 쓸 경우에 대비해 이를 ASCII 숫자로 정규화하는 것도 좋습니다. 팀들은 아랍어 사용자를 위해 앱을 현지화하거나, 걸프 지역에 사는 예멘 고객을 지원하거나, 지역 지원 계정이 여전히 인증되는지 확인할 때 이런 점검을 합니다. OTP Route는 메시지를 수신된 그대로 반환하므로, 테스트에서 파싱하는 내용이 곧 사용자가 받는 내용입니다.

예멘 전화번호는 어떤 형식인가요?

국가 코드는 +967입니다. 휴대전화 번호는 그 뒤에 아홉 자리가 오며 7로 시작해 +967 7XX XXX XXX 형태가 됩니다. 사용자가 앞에 국내용 0을 입력했다면 저장하기 전에 제거하고, 구분 기호 없는 E.164 문자열로 저장하세요. 국내 서식은 UI에서만 적용해야 합니다.

테스트용 +967 번호에 유용한 검증 사례는 다음과 같습니다.

• 사용자가 국가 목록에서 +967을 고른 뒤 코드를 포함한 전체 번호를 다시 입력하는 경우.
• 연락처 카드에서 복사한 아랍-인도 숫자가 붙여넣어지는 경우.
• 숫자 그룹 사이에 공백이나 대시가 들어가는 경우.

이들 모두가 같은 저장값으로 귀결되어야 조회와 중복 제거가 안정적입니다.

현재 +967 번호로 라우팅되는 서비스는 무엇인가요?

예멘은 OTP Gateway에서 1,700개가 넘는 서비스를 제공합니다. 실시간 스냅샷에서 자주 쓰이는 항목으로는 WhatsApp, Telegram, imo, Facebook, Instagram, TikTok, Snapchat, Google (Gmail & YouTube), X (Twitter), Microsoft & Outlook, Signal, Discord, Amazon이 있습니다.

가용성은 계속 움직이는 목표이므로 스위트가 먼저 API에 묻도록 구성하세요. 엔지니어링 밖의 사람들은 대시보드에서 같은 일을 할 수 있습니다. 이메일 코드나 Google 로그인으로 계정을 만들고, 충전한 뒤, 예멘과 서비스를 선택하고, 예멘 인증 번호를 앱에 복사한 다음 활성화 페이지에서 코드를 기다리세요.

예멘 코드가 도착하지 않는 이유와 해결 방법은 무엇인가요?

각 주문은 20분 동안 유지됩니다. SMS가 도착하지 않거나 그 전에 취소하면 전체 금액이 자동으로 지갑에 돌아오며, 도착한 코드에 대해서만 청구됩니다.

일반적인 원인과 대응은 다음과 같습니다.

• 서비스가 그 순간 느림: 포기하기 전에 시간이 끝날 때까지 기다리세요.
• 서비스가 가상 번호를 거부함: 정책을 확인하세요. 실패한 시도는 환불로 처리됩니다.
• 경로가 혼잡함: 나중에 또는 다른 서비스 경로로 시도하세요.
• 스크립트가 미수신 즉시 재주문함: 경로를 두드리지 않도록 백오프를 추가하세요.

이 번호는 자사 제품과 정당한 계정에만 사용하고, 각 서비스의 약관을 따르며, OTP Route의 Acceptable Use Policy를 준수하세요.

예멘 번호를 장기 보유할 수 있나요? 요금은 어떻게 청구되나요?

셀프 서비스로는 안 됩니다. 전용 가상 번호(Dedicated Virtual Numbers)는 월 $1.95부터 즉시 구매할 수 있으며 미국과 캐나다에서만 제공됩니다. 지속적인 +967 회선이 필요한 팀은 [email protected]으로 이메일을 보낼 수 있지만, 제공 여부는 현지 규정에 달려 있으며 확실하지 않습니다.

OTP Route 지갑은 구독도 요금제도 없는 USD 선불 방식입니다. 카드 또는 USDT/USDC로 충전하며 충전마다 PDF 인보이스가 이메일로 발송됩니다. 현재 요금은 요금제에서 확인하고, 연동 작업용으로 시뮬레이션된 번호와 코드가 필요하면 개발 계정에 샌드박스를 요청하세요.

자주 묻는 질문

현지 SIM 없이 예멘 번호로 아랍어 가입 흐름을 테스트할 수 있나요?

네. 국가 ye로 OTP Gateway 번호를 주문해 자사 앱에 입력하고, 아랍어 또는 영어 메시지를 대시보드나 웹훅에서 읽으세요.

+967 인증 코드의 가격은 얼마인가요?

코드당 $0.20부터 시작하며 서비스에 따라 다르고, 실시간 금액은 GET /api/v1/prices가 반환합니다. 도착하지 않은 코드는 20분의 시간이 끝나면 환불됩니다.

SMS가 오른쪽에서 왼쪽으로 읽히는 경우 코드는 어떻게 추출하나요?

문장 패턴이 아니라 숫자 시퀀스를 검색하고, 먼저 아랍-인도 숫자를 ASCII로 변환하세요. 코드가 텍스트의 어느 쪽에 있든 작동합니다.

+967 번호는 계속 제 것으로 보유할 수 있나요?

아니요. OTP Gateway 번호는 인증 한 번만 담당합니다. 지속되는 번호는 미국·캐나다 상품이며, 예멘은 지원팀에 이메일로 문의하세요.

지갑 잔액을 쓰지 않고 연동할 수 있나요?

네, 개발 계정에 샌드박스를 요청하세요. 시뮬레이션된 번호와 코드가 반환되어 폴링, 웹훅, 오류 처리를 테스트하기에 충분합니다.

API는 예멘에 어떤 국가 id를 사용하나요?

ye입니다. 가격 조회와 POST /api/v1/activations의 JSON 본문에 전달하세요.

서비스가 제 예멘 번호를 거절한 이유는 무엇인가요?

일부 서비스는 가상 번호를 받지 않습니다. 취소하거나 활성화가 만료되게 두면 돈이 자동으로 지갑에 돌아옵니다.

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