첫 Twitch 주문 전 사전 점검 체크리스트
번호를 요청하기 전에 다음을 확인하세요.
- 목적이 정당한가: 본인의 연동, 확장 프로그램을 테스트하거나, 조직이 소유한 채널 계정을 운영하는 경우입니다.
- API 키 준비: 개발자 콘솔에서 발급한 Bearer 키(접두사
or_live_). - 웹훅 엔드포인트 등록, 시크릿은 서버 측에 저장.
- 국가 선택: 계정의 시청자층이나 테스트 케이스에 맞춥니다.
- 지갑 충전, 또는 사전 점검용 샌드박스 요청.
- 장기 필요성 확인: 계정이 나중에 다시 인증해야 한다면 먼저 마지막 섹션을 보세요.
Twitch는 어디서 휴대폰 번호를 요구하나요?
Twitch는 가입 시 이메일 대신 휴대폰 번호를 쓰거나, 계정 확인, 비밀번호 복구, 2단계 인증을 켤 때 번호를 사용할 수 있습니다. 방송하거나 중재하거나 확장 프로그램을 운영하는 채널은 2단계 로그인을 켜는 경우가 많아, 연락 가능한 번호가 일회성 단계가 아니라 일상적인 접근의 일부가 됩니다.
QA 팀에는 테스트 형태가 두 가지라는 뜻입니다. 가입이나 확인 테스트는 코드가 한 번이면 끝나며, 바로 OTP Gateway가 제공하는 것입니다. 2단계 인증이 있는 로그인 테스트는 같은 번호로 코드가 거듭 필요하므로 대신 장기 회선이 필요합니다. 어떤 형태를 테스트하는지에 따라 필요한 제품이 달라지므로 주문 전에 정하세요.
Twitch 번호는 어느 국가에서 받아야 하나요?
Twitch는 197개 국가의 경로에서 이용할 수 있으며, 미국, 캐나다, 영국, 독일, 브라질, 일본, 멕시코, 프랑스, 스페인, 폴란드, 대한민국, 튀르키예, 필리핀, 호주 등이 포함됩니다.
번호는 계정이 속한 시장에 맞추세요. 브라질 채널의 현지화 테스트는 브라질 번호일 때 더 현실적이며, 지역별 위험 점검은 불일치를 이례적인 것으로 볼 수 있습니다. 이유는 국가 라우팅 가이드에서 설명합니다.
단계별 안내: API로 Twitch OTP 받기
GET /api/v1/services로 서비스 id가twitch인지 확인하고,GET /api/v1/countries에서 국가 id를 고릅니다.- 비용을 확인합니다.
GET /api/v1/prices?country=<id>&service=twitch. - 주문합니다.
POST /api/v1/activations에{"service": "twitch", "country": "<id>"}를 보냅니다. - 반환된 번호를 Twitch 전화번호 입력란에 입력합니다.
activation.sms_received를 기다리거나GET /api/v1/activations/{id}를 폴링합니다.- 코드를 제출하고 테스트를 마무리합니다.
기본 URL은 https://otproute.com/api/v1이며 계정당 분당 300건 요청이 가능합니다. CI 작업에서는 3~6단계를 하나의 테스트 픽스처로 묶고 teardown에서 activation을 취소하도록 하면, 중단된 실행이 주문을 남겨 두지 않습니다. 이 접근법은 CI 파이프라인에서의 SMS OTP 테스트에 나와 있습니다.
웹훅 핸들러는 어떻게 작성해야 하나요?
모든 전송에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 <t>.<raw body>에 대한 HMAC-SHA256을 다시 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프는 거부하세요. activation id를 키로 삼아 핸들러를 멱등하게 만들면 재시도된 전송이 같은 Twitch 코드를 두 번 제출하지 않습니다. 엔드포인트에 접근할 수 없다면 activation 폴링이 합리적인 대안입니다. 웹훅 기반 OTP 수신을 참고하세요.
커뮤니티 및 채널 매니저를 위한 대시보드 단계
모두가 API를 필요로 하는 것은 아닙니다. 대시보드에서 OTP Gateway를 열고 Twitch와 국가를 선택해 표시된 가격을 확인한 뒤 주문하세요. 번호를 Twitch에 입력하면 코드가 전달된 뒤 주문 옆에 나타납니다. 브랜드 계정 하나를 설정하는 채널 매니저에게 알맞은 방식입니다. 또한 스트리머의 개인 휴대폰 번호가 회사 소유 프로필에 들어가지 않도록 해 주어, 담당자가 바뀌고 접근 권한을 깔끔하게 넘겨야 할 때 중요합니다.
문제 해결: 코드 없음, 번호 거부, 만료된 창
- 아무것도 오지 않음: 20분 창이 끝날 때까지 기다리세요. 만료되거나 취소되면 전체 금액이 자동으로 환불됩니다.
- Twitch가 번호를 거부함: Twitch가 가상 번호를 거부할 수 있으니 나중에 다른 국가 경로를 시도하세요.
- 반복 실패: 짧은 간격으로 재주문하지 말고 잠시 멈추며, 전체 국제 번호를 입력하고 있는지 확인하세요.
- 잘못된 코드 제출: 핸들러가 캐시된 이전 activation이 아니라 최신 activation을 읽는지 확인하세요.
- 연동 버그: 샌드박스를 요청해 시뮬레이션된 코드로 플로우를 재현하세요.
미국 또는 캐나다 전용 번호가 더 적합한 경우
Gateway 번호는 코드를 한 번 받으면 사라집니다. Twitch 계정이 2단계 로그인이나 팀 공용 로그인의 복구 등으로 코드를 다시 필요로 한다면 전용 번호가 더 알맞은 도구입니다. 미국과 캐나다에서만 즉시 판매되며 월 $1.95부터이고, 수신 SMS를 웹훅으로 전달합니다.
어떤 쪽을 택하든 Twitch의 약관을 따르세요. 실제 개인 또는 사업자당 계정 하나입니다. OTP Route는 이용 정책(Acceptable Use Policy)에 따라 본인의 정당한 계정과 제품을 테스트하고 운영하는 용도입니다.
자주 묻는 질문
개인 휴대폰 없이 Twitch OTP를 받을 수 있나요?
네. 팀이 OTP Gateway에서 twitch 번호를 주문하고 대시보드에서 코드를 읽으면 직원의 휴대폰을 브랜드 계정에서 분리해 둘 수 있습니다.
Twitch 코드는 비용이 얼마인가요?
국가에 따라 코드당 $0.20부터입니다. 주문 전에 GET /api/v1/prices에서 실시간 가격을 확인할 수 있습니다.
Twitch가 내 번호로 코드를 보내지 않은 이유는 무엇인가요?
전달은 경로에 좌우되며 Twitch가 일부 가상 번호를 거부할 수 있습니다. 창이 끝날 때까지 기다려 자동 환불을 받은 뒤, 나중에 또는 다른 국가에서 다시 시도하세요.
Twitch용 가상 번호를 2단계 로그인에 쓸 수 있나요?
장기 회선만 의미가 있습니다. Gateway 번호는 코드를 한 번만 받으므로 미국 또는 캐나다 전용 번호를 사용하세요.
CI에서 테스트용 Twitch SMS 인증을 실행할 수 있나요?
네. 파이프라인에서 API로 주문을 시작하고 웹훅을 수신하면 됩니다. 개발 중에는 샌드박스를 쓰면 지갑 자금을 쓰지 않습니다.
OTP Route는 Twitch와 관련이 있나요?
아니요. Twitch는 해당 소유자의 상표이며 OTP Route는 Twitch와 제휴 관계가 없습니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.