API dla deweloperów
Kupuj numery z własnego oprogramowania dzięki kluczom API, rabatom hurtowym, podpisanym webhookom i endpointowi zgodnemu z sms-activate.
5 poradników · 4 krótkie odpowiedzi
Poradniki
-
Szybki start z API dla deweloperów Kupuj numery i odczytuj kody z własnego oprogramowania. Utwórz klucz, sprawdź ceny, kup numer, poczekaj na SMS i zakończ, krok po kroku.
-
Klucze API i bezpieczeństwo Zakresy, listy dozwolonych adresów IP, dzienne limity wydatków, wygasanie, rotacja bez przestojów i co zrobić, gdy klucz wycieknie.
-
Ceny hurtowe i progi ilościowe API sprzedaje po tych samych cenach co aplikacja, minus Twój rabat hurtowy: próg ilościowy według wydatków z 30 dni albo stały rabat odsprzedawcy.
-
Webhooki Odbieraj zdarzenia aktywacji na serwerze w czasie rzeczywistym, weryfikuj nagłówek SmsGrab-Signature i poznaj ponowienia, dostawy testowe oraz automatyczne wyłączanie.
-
Endpoint zgodny z sms-activate Korzystaj dalej z botów i paneli zbudowanych dla protokołu sms-activate, zmieniając jeden adres URL. Obsługiwane akcje, formaty identyfikatorów i różnice.
Krótkie odpowiedzi
Ile kosztuje API dla deweloperów?
Nie ma abonamentu: płacisz za każdy numer ze zwykłego salda. Każdy numer kosztuje tyle samo co w aplikacji, minus Twój rabat hurtowy. Progi ilościowe obniżają cenę, gdy Twoje wydatki netto z ostatnich 30 dni we wszystkich kanałach przekroczą próg, a zatwierdzeni odsprzedawcy mają stały rabat; zawsze obowiązuje wyższy z nich. Numery bez kodu są zwracane jak zwykle. Zobacz Ceny hurtowe i progi ilościowe.
Ile żądań mogę wysłać do API?
Domyślnie każdy klucz może wysłać 600 żądań i wykonać 60 zakupów na minutę, a wszystkie klucze konta razem 3000 żądań na minutę. Na konto może jednocześnie czekać na kod do 100 numerów, a na klucz może być otwartych do 20 oczekujących żądań (?wait=). Po przekroczeniu limitu dostajesz 429 RATE_LIMITED z nagłówkiem Retry-After; każda odpowiedź zawiera też nagłówki RateLimit-*. Zobacz Szybki start z API dla deweloperów.
Mój klucz API wyciekł. Co zrobić?
Działaj od razu: unieważnij klucz w Konto > Deweloperzy albo wykonaj jego rotację z okresem przejściowym 0 godzin. Unieważnienie działa natychmiast i nie wymaga hasła. Następnie sprawdź dziennik żądań klucza i Portfel pod kątem nieznanej aktywności i utwórz nowy klucz z listą dozwolonych IP i dziennym limitem wydatków. Trzymaj klucze tylko na serwerach, nigdy w aplikacjach ani na stronach. Zobacz Klucze API i bezpieczeństwo.
Czy narzędzia stworzone dla sms-activate działają z SmsGrab?
Tak, w większości przypadków. Skieruj narzędzie na https://smsgrab.com/api/stubs/handler_api.php i użyj klucza API SmsGrab jako api_key. Obsługiwane są standardowe akcje, od getBalance i getNumber po setStatus i getStatus. Kwoty są w dolarach amerykańskich według Twojej ceny z rabatem hurtowym, a nie w rublach, a wynajem nie jest dostępny. Zobacz Endpoint zgodny z sms-activate.
Inne tematy
Nadal potrzebujesz pomocy?
Napisz do nas. Odpowiadamy na każdą wiadomość, zwykle w ciągu kilku godzin.
Albo napisz na adres support@smsgrab.com