+993 투르크메니스탄 인증을 OTP 파이프라인에 연결하기

어떤 API 호출이 투르크메니스탄 인증 번호를 반환하나요?

나머지 모든 것을 좌우하므로 엔드포인트부터 시작하세요. 개발자 콘솔에서 발급한 Bearer 키로 https://otproute.com/api/v1에 인증합니다. 키의 접두사는 or_live_이며 계정당 최대 10개를 보유할 수 있습니다. 투르크메니스탄의 국가 id는 tm입니다.

1. GET /api/v1/services와 GET /api/v1/countries가 카탈로그를 알려 줍니다. 캐시해 두되 매일 새로 고치세요.
2. GET /api/v1/prices?country=tm&service=<id>는 현재 가격과 해당 서비스의 경로가 열려 있는지 알려 줍니다.
3. {"service": "imo", "country": "tm"}와 함께 POST /api/v1/activations를 호출하면 +993 번호가 예약되고 활성화 id가 반환됩니다.
4. GET /api/v1/activations/{id}는 +993 주문의 상태를 반환하며, SMS가 도착하면 코드도 포함됩니다.
5. POST /api/v1/activations/{id}/cancel은 테스트에 더는 필요 없는 주문을 해제합니다.
6. GET /api/v1/balance로 파이프라인이 잔액 부족 시 일찍 멈출 수 있습니다.

계정 한도는 분당 300건이며 모든 키가 공유합니다. 요청과 응답 형식은 API 레퍼런스에 문서화되어 있습니다.

+993 테스트는 웹훅을 수신해야 하나요, 폴링해야 하나요?

개발자 한 명이 흐름을 직접 눌러 보는 정도라면 폴링으로 충분합니다. 여러 작업이 동시에 돌기 시작하면 웹훅이 더 저렴하고 반응도 빠릅니다. 계정에는 웹훅 엔드포인트를 5개까지 둘 수 있으니, 하나를 투르크메니스탄 테스트 러너로 지정해 activation.sms_received, activation.expired, activation.cancelled를 받으세요.

모든 전송은 검증되기 전까지 신뢰할 수 없는 것으로 다루세요. X-OTPRoute-Signature 헤더를 t와 v1로 나누고, t, 마침표, 정확한 원본 본문에 엔드포인트 시크릿으로 HMAC-SHA256을 계산해 상수 시간으로 비교합니다. 재전송 공격을 막으려면 짧은 허용 범위를 벗어난 타임스탬프는 거부하세요. 결과는 활성화 id를 키로 저장해서 재시도된 전송이 아무것도 바꾸지 않게 하세요. 웹훅 기반 OTP 수집 글에서는 큐 기반 핸들러를, CI 파이프라인 테스트에서는 빌드 잡의 타임아웃 처리를 다룹니다.

투르크메니스탄 인증 번호로 무엇을 인증할 수 있나요?

tm 경로에는 1,600개가 넘는 서비스가 나열되어 있습니다. 현재 자주 요청되는 서비스는 imo, Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI), Viber, WeChat, Discord, Snapchat입니다. 중앙아시아에서는 메신저 앱이 일상 트래픽의 큰 부분을 차지하기 때문에 목록에 많이 올라 있습니다.

이는 스냅샷일 뿐 계약이 아닙니다. 제휴 통신사의 용량은 하루 동안 바뀌므로 어제의 목록이 여전히 유효하다고 가정하지 말고 실행 전마다 가격을 조회하세요.

+993 번호는 어떤 형식이며 현지화는 어떻게 하나요?

투르크메니스탄의 국내 유효 번호는 8자리이며 대부분의 휴대전화 대역은 6으로 시작합니다. 국내에서는 앞에 트렁크 접두사 8을 누르고, 국제 형식에서는 이 접두사를 빼서 +993 뒤에 8자리가 붙습니다.

• 시스템 경계에서 E.164(+9936XXXXXXX)로 정규화하고 그 값만 저장하세요.
• 이웃 나라용으로 작성한 검증 로직을 재사용하지 마세요. 중앙아시아는 나라마다 길이와 접두사가 다릅니다.
• 투르크멘어가 공용어이며 ä, ç, ň, ö, ş, ü, ý, ž 같은 글자가 있는 라틴 알파벳으로 씁니다. 러시아어도 널리 통합니다. 따라서 인증 SMS는 투르크멘어, 러시아어, 영어로 올 수 있으므로, 추출기는 어떤 UTF-8 본문에서든 숫자를 읽어야 합니다.

팀들은 보통 중앙아시아 출시를 계획할 때, 투르크멘어나 러시아어 인터페이스의 현지화 QA가 필요할 때, 또는 아시가바트와 인접 시장을 오가는 고객을 응대할 때 여기서 테스트합니다.

코드를 작성하지 않고도 +993 코드를 주문할 수 있나요?

네. 이메일 코드나 Google로 가입하고 지갑에 충전한 뒤 OTP Gateway를 열어 서비스를 고르고 투르크메니스탄을 선택한 다음 표시된 가격을 확인하고 주문하세요. +993 번호가 바로 나타나며, 앱이 요구하는 곳에 입력하고 SMS를 요청한 뒤 활성화 카드에서 코드를 확인하면 됩니다. 이 번호는 그 한 번의 인증에만 사용됩니다.

투르크메니스탄 코드가 도착하지 않는 이유는 무엇일까요?

• 서비스가 가상 번호를 거부합니다. 일부 서비스는 그렇습니다. 이는 상대 서비스의 정책이며, 환불 규칙은 바로 이런 경우를 위해 존재합니다.
• 경로가 혼잡합니다. 나중에 다시 시도하거나 새 활성화로 시도하세요. 다른 번호가 사용됩니다.
• 시간 창을 일찍 끊었습니다. 활성화를 20분 내내 열어 두세요. 만료된 주문은 자동으로 환불됩니다.
• 재시도 루프가 너무 공격적입니다. 주문을 연달아 넣지 말고 시도 사이에 간격을 두세요.

이런 단계는 풀을 함께 쓰는 모두를 위해 OTP 라우팅을 건강하게 유지합니다.

투르크메니스탄 장기 회선이 있나요? 결제는 어떻게 되나요?

투르크메니스탄에는 셀프서비스 Dedicated Number가 없습니다. OTP Route는 장기 회선을 미국과 캐나다에서만 월 $1.95부터 판매합니다. 다른 국가에 대한 요청은 [email protected]으로 보낼 수 있으나, 현지 규정이 허용한다는 보장은 없습니다.

그 밖의 모든 것은 월 요금이 없는 하나의 선불 USD 지갑으로 처리됩니다. 카드 또는 USDT/USDC로 결제하고, 충전마다 PDF 인보이스를 받으며, 개발 계정에 샌드박스 모드를 요청해 시뮬레이션된 번호로 SMS 인증 API를 테스트할 수 있습니다. 본인의 합법적인 제품과 계정에만 사용하고, 각 서비스의 약관과 당사의 허용 가능 사용 정책을 지키세요.

자주 묻는 질문

제 앱의 가입 테스트용 +993 번호를 받을 수 있나요?

네. 국가 id tm과 원하는 서비스로 활성화를 만든 뒤, 반환된 번호를 본인의 가입 흐름에 사용하세요.

OTP Route에서 투르크메니스탄 인증 코드는 얼마인가요?

코드당 $0.20부터입니다. 서비스별 실시간 가격은 가격 엔드포인트에서 제공되며 대시보드에도 표시됩니다.

투르크멘 번호를 입력할 때 접두사 8을 넣어야 하나요?

아니요. 8은 국내 다이얼용이므로 +993과 8자리 국내 번호를 사용하세요.

+993 코드에 대한 웹훅이 정말 OTP Route에서 온 것인지 어떻게 알 수 있나요?

X-OTPRoute-Signature 헤더의 HMAC-SHA256 서명을 원본 본문에 대해 검증하고, 오래된 타임스탬프는 거부하세요.

투르크메니스탄 번호로 SMS가 도착하지 않으면 자동으로 환불되나요?

네. 20분의 시간 창이 만료되거나 취소하면 청구된 금액 전액이 지갑으로 돌아갑니다.

반복 로그인을 위해 투르크메니스탄 번호를 계속 보유할 수 있나요?

셀프서비스로는 불가능합니다. 장기 번호는 미국과 캐나다에만 제공되며, 특별한 요구 사항이 있다면 지원팀에 이메일로 문의하세요.

투르크멘 OTP 메시지는 어떤 언어로 오나요?

앱에 따라 다릅니다. 투르크멘어, 러시아어, 영어 모두 가능하므로 단어가 아닌 숫자를 파싱하세요.

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