카타르 OTP API 호출 순서는 어떻게 되나요?
모든 요청은 https://otproute.com/api/v1 아래에 있으며 or_live_로 시작하는 Bearer 키로 인증합니다. 키는 최대 10개까지 보유할 수 있으므로 CI, 스테이징, 운영 스크립트에 각각 다른 키를 주면 다른 키에 영향 없이 하나만 폐기할 수 있습니다. +974 활성화 한 건은 최대 네 번의 호출로 끝납니다.
GET /api/v1/prices?country=qa&service=<id>는 실시간 가격을 반환하고 해당 서비스 경로가 지금 열려 있는지 알려 줍니다.POST /api/v1/activations에{"service": "<id>", "country": "qa"}를 보내면 카타르 번호가 예약되고 활성화 ID가 반환됩니다.GET /api/v1/activations/{id}는 폴링용 호출로, 카타르 주문의 진행 상태를 보여 주고 전달 후에는 코드를 포함합니다.POST /api/v1/activations/{id}/cancel은 주문을 일찍 종료하고 금액을 지갑으로 돌려줍니다.
보조 호출 두 가지도 있습니다. GET /api/v1/services는 이름을 서비스 ID에 매핑하고, GET /api/v1/balance는 잔액이 바닥나기 전에 파이프라인을 멈추게 해 줍니다. 트래픽은 계정당 분당 300건 이하로 유지하세요. 참고 페이지는 개발자 개요에 모여 있습니다.
웹훅 핸들러는 카타르 활성화 이벤트를 어떻게 처리해야 하나요?
폴링도 동작하지만, 웹훅을 쓰면 테스트 러너가 이벤트가 발생하는 즉시 반응할 수 있습니다. 엔드포인트를 최대 다섯 개 등록하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요. 첫 번째 이벤트에 코드가 담기며, 나머지 둘은 러너에게 대기를 멈추라고 알려 줍니다.
각 요청에는 t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature가 들어 있습니다. 서명 대상 문자열을 타임스탬프, 점, 원본 요청 본문 순으로 다시 구성하고, 엔드포인트 시크릿으로 HMAC-SHA256을 계산한 뒤 상수 시간으로 비교하세요. 타임스탬프가 오래된 요청은 거부합니다. 재시도로 같은 이벤트가 여러 번 전달될 수 있으므로 활성화 ID를 저장하고 반복은 무시하세요. 참조 구현은 웹훅 기반 OTP 수신에서 볼 수 있습니다.
+974 번호로 코드를 보낼 수 있는 서비스는 무엇인가요?
카타르는 폭넓은 경로 중 하나로, 최신 스냅샷 기준 1,600개 이상의 서비스가 있습니다. 인기 항목은 WhatsApp, Google (Gmail & YouTube), Microsoft & Outlook, Telegram, Instagram, Facebook, LinkedIn, Snapchat, TikTok, Uber, Airbnb, ChatGPT (OpenAI), Claude, Discord 등입니다.
재고는 하루 중에도 바뀌므로 스냅샷은 참고용으로만 보고 최종 판단은 API 응답에 맡기세요. 일부 서비스는 가상 번호를 거부하며, 그런 경우 주문은 그냥 만료되고 금액이 환불됩니다. 위에 나온 이름은 각 소유자의 상표이며 제휴 관계를 의미하지 않습니다.
테스트 픽스처에서 카타르 번호 정규화하기
카타르 번호는 +974 뒤에 8자리가 오고 트렁크 접두사가 없으므로, 국내 번호를 국제 형식으로 바꿀 때 제거할 것이 없습니다. 픽스처는 E.164(+974와 8자리)로 유지하고, 사용자가 00974, 공백, 다른 나라의 습관에서 넘어온 불필요한 앞자리 0을 넣어 입력하더라도 정리하세요.
아랍어가 공용어이고, 영어는 비즈니스와 외국인 비중이 큰 인구 사이에서 널리 쓰입니다. 따라서 인증 문자는 발신 서비스가 계정에 맞춰 고르는 언어, 흔히 영어나 아랍어로 도착합니다. 추출 로직이 두 문자 체계에서 모두 코드를 찾는지, 아랍어 UI에서 오른쪽에서 왼쪽 레이아웃에도 OTP 입력란이 사용 가능한지 확인하세요.
팀들은 GCC 출시, 아랍어 사용자를 위한 소비자 앱 현지화, 도하의 호텔·물류 운영, 직원 개인 번호 없이 지역 비즈니스 계정을 인증할 때 카타르 경로를 테스트합니다. CI 테스트 가이드에서 이러한 점검을 자동 실행에 연결하는 방법을 볼 수 있습니다.
대신 대시보드에서 카타르 확인 실행하기
모든 인증에 스크립트가 필요한 것은 아닙니다. 대시보드에서 OTP Gateway를 열고 카타르와 서비스를 선택한 뒤 표시된 가격을 확인하고 확정하세요. +974 번호를 앱에 복사해 SMS를 요청하면 코드가 주문에 나타납니다. 20분의 유효 시간은 주문한 순간부터 계산되며, 코드가 도착한 경우에만 요금을 냅니다.
코드가 오지 않을 때: 디버깅 체크리스트
- 충분히 기다렸나요? 실패로 판단하기 전에 활성화가 유효 시간을 모두 채우게 하세요.
- 가상 번호를 허용하나요? 일부 서비스는 가상 번호를 차단하며, 반복 시도해도 달라지지 않습니다.
- 재시도 정책이 적절한가요? 백오프를 두고 나중에 다시 시도하거나 같은 서비스의 다른 경로로 바꾸세요. 짧은 간격의 재주문은 요청 한도만 낭비하고 거의 도움이 되지 않습니다.
- 핸들러가 정상인가요? 서명 검증이 실패하거나 엔드포인트가 오류를 반환한다면
GET /api/v1/activations/{id}를 폴링해 웹훅이 놓친 사이 코드가 전달되었는지 확인하세요.
SMS 없이 끝난 활성화는 만료든 취소든 전액 환불됩니다.
카타르 장기 회선이 있나요? 사용량은 어떻게 청구되나요?
카타르에는 셀프서비스 장기 번호가 없습니다. Dedicated Virtual Numbers(인바운드·아웃바운드 SMS, 웹훅 전달, 브라우저 통화가 가능한 전용 회선)는 미국과 캐나다에서만 제공되며 월 $1.95부터입니다. 카타르 관련 요구 사항은 [email protected]으로 문의하세요. 가능한 범위는 현지 규정이 결정합니다.
카타르 사용량은 선불 USD 지갑 하나에서 차감되며 월 청구는 없습니다. 카드 또는 USDT/USDC로 충전하고, 충전할 때마다 PDF 인보이스를 받으세요. 모의 번호로 연동을 테스트하고 싶다면 개발 계정에 샌드박스 모드를 요청하세요. +974 번호는 자신의 제품과 합법적인 비즈니스 계정에만 사용하고, 각 서비스의 약관을 존중하며, OTP Route의 이용 정책(Acceptable Use Policy)을 따르세요.
자주 묻는 질문
자동화 테스트에서 카타르 SMS OTP 코드를 받으려면 어떻게 하나요?
국가 qa로 활성화를 생성하고, 반환된 번호를 테스트 중인 앱에 입력한 뒤 activation.sms_received 웹훅을 기다리세요. 테스트 러너가 인바운드 요청을 받을 수 없다면 OTP Route의 활성화 폴링도 지원됩니다.
카타르 SIM 없이 +974 번호로 테스트할 수 있나요?
네. OTP Gateway가 코드 한 건용 카타르 인증 번호를 제공하므로, 현지 SIM이나 기기 없이도 가입·로그인 플로우를 테스트할 수 있습니다.
주문 전에 카타르 가격은 어떻게 확인하나요?
GET /api/v1/prices?country=qa&service=<id>를 호출하거나 대시보드를 확인하세요. 요금은 $0.20(코드당)부터 시작하며 서비스에 따라 다릅니다.
실패한 카타르 활성화에도 요금이 청구되나요?
아니요. 코드가 도착할 때만 청구되며, 만료되거나 취소된 활성화는 지갑으로 자동 환불됩니다.
왜 인접 국가가 아니라 카타르 번호로 테스트해야 하나요?
계정의 실제 시장과 일치하는 국가를 고르세요. 제품을 카타르에 출시한다면 +974 번호가 고객이 접할 국가 코드 처리, 언어, OTP 라우팅을 그대로 검증해 줍니다. 자세한 내용은 OTP 국가별 라우팅에서 설명합니다.
개발 계정을 지갑 잔액 없이 사용할 수 있나요?
네. 요청하면 개발 계정을 샌드박스로 전환할 수 있으며, 엔드투엔드 테스트용 모의 번호와 코드가 반환됩니다.
반복 로그인을 위해 카타르 번호를 계속 보유할 수 있나요?
셀프서비스로는 불가능합니다. 전용 회선은 미국과 캐나다로 제한되어 있기 때문입니다. 카타르 장기 회선이 궁금하면 [email protected]으로 문의하세요.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.