Weryfikacja SMS w Tunezji (+216): lista kontrolna dla deweloperów

Co powinno znaleźć się na liście kontrolnej przed zamówieniem numeru +216?

Przejdź raz przez tę listę, a większość testów dla Tunezji przebiegnie gładko:

• Klucz API gotowy. Utwórz klucz Bearer w konsoli deweloperskiej; klucze produkcyjne zaczynają się od or_live_.
• Portfel zasilony. OTP Gateway pobiera środki z przedpłaconego salda w USD; GET /api/v1/balance potwierdzi to ze skryptu.
• Webhook osiągalny. Zarejestruj endpoint HTTPS, zapisz jego sekret i upewnij się, że zegar serwera jest dokładny, aby kontrole znaczników czasu przechodziły.
• Cena sprawdzona. Wywołaj GET /api/v1/prices?country=tn&service=<id> dla dokładnie tej usługi, którą planujesz testować.
• Pole telefonu przetestowane. Upewnij się, że Twój formularz przyjmuje ośmiocyfrowy tunezyjski numer krajowy oraz wklejony numer międzynarodowy +216.
• Parser tolerancyjny. Potwierdź, że wyodrębnianie kodu działa dla treści w języku arabskim, francuskim i angielskim (patrz niżej).
• Regulaminy sprawdzone. Testujesz własny produkt lub obsługujesz własne, legalne konto, zgodnie z zasadami usługi i Polityką Dopuszczalnego Użytkowania OTP Route.

Jak formatować tunezyjskie numery do E.164?

Tunezja ma zamknięty plan numeracji: każdy numer abonenta ma osiem cyfr i nie ma prefiksu krajowego, więc przed dodaniem kodu kraju nie trzeba niczego usuwać. Forma E.164 to po prostu +216 i te osiem cyfr. Mieszkańcy często zapisują numery w grupach, takich jak xx xxx xxx, więc przy normalizacji usuwaj spacje, kropki i myślniki. Unikaj walidacji względem stałej listy cyfr początkowych; kontrola długości plus sprawdzona biblioteka telefoniczna jest bezpieczniejsza niż ręcznie pisana tabela zakresów.

W jakich językach przychodzą tunezyjskie teksty weryfikacyjne?

Językiem urzędowym jest arabski, na co dzień mówi się po tunezyjsku (arabski tunezyjski), a francuski jest powszechny w biznesie, administracji i wielu aplikacjach. W rezultacie w jednym przebiegu testu możesz zobaczyć kody po francusku, angielsku lub arabsku, zależnie od nadawcy i ustawień urządzenia.

Wiadomości arabskie podróżują jako SMS-y Unicode i mogą zawierać znaczniki kierunku pisma od prawej do lewej wokół cyfr. Wyrażenie regularne, które łapie pierwszy ciąg od czterech do ośmiu cyfr ASCII po usunięciu niewidocznych znaczników, działa dla wszystkich trzech języków. Zespoły zwykle dodają Tunezję do macierzy przy premierach we frankofońskiej Afryce Północnej obok Maroka i Algierii, do QA lokalizacyjnego układów od prawej do lewej albo dlatego, że obsługują klientów tunezyjskich mieszkających w Europie; numer +216 do testów pokrywa każdy z tych przypadków.

Krok po kroku: odbiór tunezyjskiego OTP przez API

Aktualny zrzut wymienia ponad 1700 usług dla Tunezji, w tym Facebook, WhatsApp, Instagram, Telegram, TikTok, Google (Gmail i YouTube), Snapchat, Signal, LinkedIn, Discord, ChatGPT (OpenAI), Microsoft & Outlook, Amazon i Uber. Dostępność zmienia się w ciągu dnia, więc pozwól swojej logice routingu OTP odczytać ją z GET /api/v1/services i GET /api/v1/countries na początku przebiegu.

1. Wyślij POST /api/v1/activations z {"service": "facebook", "country": "tn"} i zapisz identyfikator aktywacji.
2. Wpisz zwrócony numer w testowanej aplikacji i wywołaj wysłanie kodu.
3. Obsłuż activation.sms_received na webhooku: zweryfikuj X-OTPRoute-Signature (HMAC-SHA256 z znacznika czasu, kropki i surowej treści), odrzucaj stare znaczniki czasu i ignoruj duplikaty dla identyfikatora aktywacji, który już przetworzyłeś.
4. Bez webhooka odpytuj GET /api/v1/activations/{id}, trzymając się wyraźnie poniżej limitu 300 żądań na minutę.
5. Wywołaj POST /api/v1/activations/{id}/cancel, jeśli test zostanie przerwany.

Dokumentacja API wymienia każde pole, a przewodnik po testach w CI pokazuje, jak wpiąć to w pipeline.

Krok po kroku z poziomu panelu

1. Załóż konto za pomocą e-maila i sześciocyfrowego kodu albo logowania przez Google i włącz uwierzytelnianie dwuskładnikowe TOTP.
2. Dodaj środki kartą lub USDT/USDC.
3. Wybierz Tunezję, potem usługę, i sprawdź wyświetloną cenę.
4. Zamów, skopiuj numer +216 i poproś o kod w docelowej aplikacji.
5. Skopiuj tunezyjski kod z panelu, gdy tylko się pojawi, i dokończ testowaną rejestrację.

Rozwiązywanie problemów: co, jeśli kod +216 nie pojawia się?

Każda aktywacja trwa 20 minut, a płacisz tylko wtedy, gdy kod dotrze. Jeśli okno upłynie albo anulujesz zamówienie, pełna kwota wraca do portfela.

• Nic nie dotarło: poczekaj do końca okna, a potem spróbuj później lub przez inną trasę usługi, jeśli test na to pozwala.
• Usługa odrzuciła numer: niektóre usługi odrzucają numery wirtualne; zwrot obejmuje ten przypadek.
• Webhook milczy, ale panel pokazuje kod: prawdopodobnie nie przechodzi Twoja kontrola podpisu; porównuj z surową treścią, a nie z ponownie zserializowanym JSON-em, i sprawdź dryf zegara.
• Kilka niepowodzeń z rzędu: dodaj back-off; ponowne zamawianie w ciasnej pętli rzadko pomaga.

Linie długoterminowe, rozliczenia i sandbox dla Tunezji

Nie ma samoobsługowego długoterminowego numeru tunezyjskiego. Numery dedykowane (Dedicated Numbers) to produkt dla USA i Kanady od $1.95/month; jeśli potrzebujesz trwałej linii +216, napisz na [email protected], pamiętając, że dostępność zależy od lokalnych przepisów.

Portfel działa w modelu pay as you go bez opłaty miesięcznej, a każde doładowanie dostaje fakturę PDF e-mailem. Konta deweloperskie mogą poprosić o tryb sandbox, w którym symulowane numery i kody pozwalają sprawdzić integrację bez wydawania salda.

Najczęstsze pytania

Czy mogę przetestować tunezyjski proces rejestracji bez tunezyjskiej karty SIM?

Tak. Użyj numeru +216 z OTP Gateway i odbierz kod w panelu albo przez API weryfikacji SMS i webhooki.

Czy tunezyjskie numery mają prefiks krajowy do usunięcia?

Nie. Numery tunezyjskie mają osiem cyfr bez prefiksu krajowego, więc forma E.164 to po prostu +216 i te cyfry.

Jaki jest identyfikator kraju w OTP API dla Tunezji?

Użyj tn w zapytaniu o ceny i w treści żądania POST /api/v1/activations.

Ile kosztuje numer weryfikacyjny z Tunezji?

Od $0.20 za kod; dokładna kwota zależy od usługi i jest widoczna w panelu oraz w endpoincie cen przed zamówieniem. Zobacz cennik.

Mój parser nie radzi sobie z arabskimi wiadomościami OTP. Co zmienić?

Usuń znaczniki kierunku Unicode i dopasowuj ciąg cyfr zamiast otaczających słów, aby ta sama reguła działała dla treści arabskich, francuskich i angielskich.

Czy mogę zachować numer +216 na późniejsze logowania?

Nie w trybie samoobsługowym. Numer Gateway obsługuje jeden kod, a natychmiast dostępne linie długoterminowe istnieją tylko w USA i Kanadzie.

Nazwy usług są znakami towarowymi ich właścicieli. OTP Route nie jest z nimi powiązany. Korzystaj z numerów zgodnie z prawem oraz przestrzegaj regulaminów poszczególnych usług i naszej Polityki akceptowalnego użytkowania.