에티오피아(+251) SMS 코드를 테스트 파이프라인으로 가져오기

에티오피아 인증번호를 가져오려면 어떤 API를 호출하나요?

에티오피아용 OTP 라우팅은 https://otproute.com/api/v1에 대한 다섯 가지 단순한 HTTP 호출로 이루어집니다. 모든 호출은 Developer 콘솔에서 생성한 or_live_로 시작하는 Bearer 키로 인증합니다. 계정은 키를 최대 10개까지 보유할 수 있으므로 CI, 스테이징, 로컬 노트북에 각각 다른 자격 증명을 쓸 수 있습니다.

1. GET /api/v1/countries는 모든 경로를 나열하며, 에티오피아는 ID et로 나타납니다.
2. GET /api/v1/services는 서비스 ID를 반환하고, GET /api/v1/prices?country=et&service=<id>는 테스트하려는 조합의 현재 가격과 가용성을 알려 줍니다.
3. {"service": "telegram", "country": "et"}로 POST /api/v1/activations를 호출하면 +251 번호가 예약되고 activation id가 반환됩니다.
4. 그 번호를 테스트 대상 제품의 전화번호 입력란에 넣고 SMS 발송을 일으킵니다.
5. 웹훅 이벤트나 GET /api/v1/activations/{id} 폴링으로 코드를 읽고, 실행을 깔끔하게 중단하려면 POST /api/v1/activations/{id}/cancel을 호출합니다.

재고는 하루 중에도 움직이므로 아무것도 하드코딩하지 말고 실행 시점에 가격 엔드포인트를 호출하세요. 스위트 시작 전에 GET /api/v1/balance를 한 번 확인하면 지갑 잔액이 부족할 때 작업을 일찍 멈출 수 있습니다. 이 SMS 인증 API의 요청과 응답 형식은 개발자 문서에 있습니다.

+251 활성화를 위한 서명된 웹훅은 어떻게 연결하나요?

폴링은 단일 테스트에는 충분하지만, 병렬 작업은 이벤트를 푸시로 받을 때 이해하기 쉽습니다. 계정당 최대 5개의 웹훅 엔드포인트를 등록하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요.

모든 요청에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 다시 계산하고, 결과를 v1과 상수 시간 비교로 대조하며, 타임스탬프가 오래되었다면 요청을 거부하세요. 검증은 JSON 파서가 건드리기 전의 원본 바이트에서 수행해야 합니다.

이벤트가 두 번 이상 전달될 수 있다고 가정하세요. 핸들러를 activation id 기준으로 만들고 중복은 버리면, 재시도된 이벤트가 OTP 입력란을 두 번 채우는 일이 없습니다. 폴링을 유지한다면 몇 초 간격은 분당 300건이라는 한도 안에서 여유가 있습니다. HMAC으로 OTP 웹훅 보호하기에 참고용 핸들러가 포함되어 있습니다.

지금 에티오피아 SMS OTP 코드를 받을 수 있는 서비스는 무엇인가요?

에티오피아 경로에는 현재 1,700개가 넘는 서비스가 올라와 있습니다. 실시간 스냅샷에서 인기 있는 항목으로는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber, imo, Netflix 등이 있습니다.

이 목록은 스냅샷으로 취급하세요. 개별 서비스의 가용성은 몇 시간 안에도 바뀔 수 있으므로 API가 정적 표 대신 실시간으로 보고합니다. 매 실행 시작 때 국가와 가격 엔드포인트를 조회하고, 흔하지 않은 서비스가 필요하면 대시보드에서 전체 카탈로그를 검색하세요.

QA 팀이 +251 번호 형식과 SMS 언어에 대해 알아야 할 것은 무엇인가요?

에티오피아 번호의 E.164 형식은 +251 뒤에 9자리가 이어지는 것입니다. 국내에서는 이 9자리 앞에 0을 눌러 거는 것이 일반적이므로 사용자가 양식에 09…로 입력하는 경우가 많습니다. 이 국내 접두 0을 제거하고 +251을 붙여 표준 E.164 문자열로 저장하며, 현지식 표기는 화면에만 보여 주세요. 전화번호 입력 검증은 가입 버그가 가장 많이 숨는 곳이므로 두 가지 입력과 공백, 대시가 섞인 경우까지 모두 테스트하세요.

암하라어가 연방 업무 언어이며 에티오피아 문자(게즈 문자)로 쓰고, 오로모어, 티그리냐어, 소말리어는 각 지역에서 널리 쓰입니다. 대부분의 국제 서비스는 코드를 영어로 보내지만 현지화된 템플릿은 암하라어로 올 수 있습니다. 주변 단어를 매칭하지 말고 패턴으로 숫자를 추출하며, 로그가 UTF-8을 깨끗하게 저장하는지 확인하세요.

팀이 이 경로를 테스트하는 대표적인 경우는 에티오피아 사용자를 위한 앱 출시, 암하라어 현지화 점검, 본국 번호로 가입하는 디아스포라 고객 대응입니다. 제품이 날짜를 표시한다면 에티오피아 고유의 달력도 별도 현지화 케이스로 추가할 만합니다. 다른 팀이 이런 스위트를 구성하는 방법은 QA 테스트 페이지에서 볼 수 있습니다.

비개발자도 대시보드에서 에티오피아 인증번호를 받을 수 있나요?

네. 제품 매니저와 지원 담당자도 코드를 작성하지 않고 같은 흐름을 실행할 수 있습니다.

1. 이메일과 6자리 코드 또는 Google 로그인으로 계정을 만들고 TOTP 2단계 인증을 켭니다.
2. 지갑에 자금을 충전합니다.
3. 에티오피아를 고르고 서비스를 선택한 뒤, 확인하기 전에 표시된 가격을 읽습니다.
4. 인증하려는 앱에 +251 번호를 붙여 넣습니다.
5. 활성화를 열어 둡니다. 코드가 수신되면 그곳에 표시됩니다.

많은 팀이 엔지니어가 같은 경로를 API로 구동하는 동안 일회성 점검에 이 방법을 사용합니다.

+251 코드가 오지 않으면 어떻게 되나요?

각 활성화는 20분간 열려 있습니다. 코드가 도착한 경우에만 결제되며, SMS 없이 시간이 끝나거나 여러분이 취소하면 전액이 지갑으로 자동 환불됩니다.

아무것도 오지 않을 때는 다음을 확인하세요.

• 소요 시간은 서비스와 경로에 따라 다르므로, 실패로 단정하기 전에 시간을 끝까지 두세요.
• 나중에 다시 시도하거나, 테스트 케이스가 허용하면 다른 서비스 경로로 바꾸세요.
• 해당 서비스가 가상 번호를 받아주는지 확인하세요. 일부는 거부하며, 환불은 바로 그런 상황을 위해 존재합니다.
• 짧은 간격으로 반복 주문하지 마세요. 재시도 간격을 두고 각 activation id를 기록하면 패턴이 보입니다.

추가 점검 항목은 OTP 전달 실패 줄이기 글에 정리되어 있습니다.

장기 에티오피아 회선이 있나요? 요금은 어떻게 처리되나요?

OTP Route에는 에티오피아용 셀프서비스 장기 번호가 없습니다. 갱신되는 동안 보유하는 회선인 Dedicated Numbers는 미국과 캐나다 전용 상품으로 월 $1.95부터입니다. 지속적으로 사용할 +251 회선이 필요하다면 [email protected]으로 문의하세요. 가능 여부는 현지 규정에 따르며 보장되지 않습니다.

에티오피아 활성화는 선불 USD 지갑 하나에서 차감되며 월 요금도 고를 요금제도 없습니다. 카드나 USDT/USDC 스테이블코인으로 충전하면 충전할 때마다 PDF 인보이스가 받은편지함에 도착합니다. 새 연동에 실제 자금을 쓰기 전에 개발용 계정의 샌드박스 모드를 요청하세요. 시뮬레이션된 번호와 코드가 반환되어 전체 흐름을 처음부터 끝까지 실행해 볼 수 있습니다.

OTP Route의 에티오피아 테스트 번호는 귀사가 실제로 소유한 제품과 계정을 검증하는 용도입니다. 각 서비스의 약관과 당사의 Acceptable Use Policy가 계속 적용됩니다.

자주 묻는 질문

현지 SIM 없이 우리 앱의 에티오피아 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 해당 서비스용 +251 번호를 주문해 앱에 입력하고, 대시보드나 API에서 코드를 읽으세요. 코드가 도착한 경우에만 요금이 청구됩니다.

OTP Route API에서 에티오피아의 국가 ID는 무엇인가요?

et입니다. 에티오피아 활성화를 만들 때와 가격을 조회할 때 country 필드로 et를 보내세요.

테스트용 +251 번호는 얼마인가요?

코드당 $0.20부터 시작합니다. 서비스별 정확한 금액은 GET /api/v1/prices가 반환하며 주문 전에 대시보드에도 표시됩니다.

에티오피아 전화번호를 앞자리 0과 함께 저장해야 하나요?

아니요. E.164 형식인 +251에 9자리를 붙인 형태를 유지하고, 사용자가 입력한 국내 0은 제거하세요. 현지식 서식은 화면에서만 적용합니다.

에티오피아 인증 문자는 암하라어로 오나요?

보통은 영어로 오지만, 서비스에 따라 에티오피아 문자의 암하라어 템플릿을 쓸 수도 있습니다. 문구가 아니라 숫자를 파싱하면 어느 쪽이든 동작합니다.

나중 로그인을 위해 에티오피아 번호를 계속 보유할 수 있나요?

셀프서비스로는 불가능합니다. 일회용 번호는 코드 한 건만 받기 때문입니다. 다시 로그인해야 하는 계정에는 미국 또는 캐나다의 Dedicated Number가 알맞고, 에티오피아에 대해서는 지원팀에 이메일로 문의할 수 있습니다.

지갑 잔액을 쓰지 않고 에티오피아 OTP API를 시험해 볼 방법이 있나요?

네. 개발용 계정에 샌드박스 모드를 요청하면 시뮬레이션된 번호와 코드가 반환되어 연동을 종단 간으로 테스트할 수 있습니다.

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