SMS4You'ın Genel Erişimli API'sini Tanıtıyoruz: SMS Alımını ve Numara Yönetimini Otomatikleştirin
Birçoğunuzun uzun süredir beklediği bir yeniliği duyurmaktan büyük heyecan duyuyoruz: SMS4You genel API'si. Artık hesabınızda manuel olarak yaptığınız her şeyi programlı olarak gerçekleştirebilirsiniz: numara satın alma, SMS ve e-postadan kodları alma, bakiyenizi ve tarifelerinizi takip etme. Komut dosyalarınız, botlarınız ve kayıt sistemleriniz, tek bir tıklama bile yapmanıza gerek kalmadan SMS4You ile doğrudan çalışabilir.
Aşağıda, tam olarak neyi piyasaya sürdüğümüzü, neden buna ihtiyacınız olduğunu ve beş dakika içinde nasıl başlayabileceğinizi açıklayacağız.
Önemli Özelliklere Genel Bakış
OTP aktivasyonları (SMS alımı) ve e-posta aktivasyonları için tam özellikli bir REST API.
Ülkeler, hizmetler ve güncel fiyatların yer aldığı bir katalog; hesabınızda görünen her şey API üzerinden de erişilebilir.
Webhook'lar: Kodlar ve durum güncellemeleri, sürekli sorgulama yapmaya gerek kalmadan otomatik olarak sunucunuza gönderilir.
SMS-Activate protokolüyle uyumluluk: Yalnızca bir adresi değiştirerek mevcut entegrasyonlarınızı taşıyın.
Hesabınızda kendiniz oluşturduğunuz bir token aracılığıyla basit kimlik doğrulama.
İstekleri doğrudan tarayıcınızda test etme özelliğine sahip etkileşimli belgeler.
Neden bir API'ye ihtiyacınız var?
Sayıları manuel olarak satın almak, yalnızca birkaç aktivasyon olduğunda işe yarar. Ancak onlarca veya yüzlerce kayıtla uğraşmaya başladığınızda, toplu işleme yaptığınızda veya SMS alımını kendi ürününüze entegre ettiğinizde, arayüzde tıklamalar yapmak zahmetli hale gelir. API tam da bu sorunu çözer: Mantığı kodda bir kez tanımlarsınız ve geri kalan her şey, herhangi bir ölçekte ve günün herhangi bir saatinde otomatik olarak gerçekleşir.
Bunu geliştirmemize neden olan tipik senaryolar:
yazılımınızda otomatik hesap kaydı ve doğrulama;
ardışık olarak çok sayıda telefon numarası gerektiren toplu işlem ve testler;
SMS kodu alımını doğrudan hizmetinize veya ürününüze entegre etme;
başlangıçta diğer sağlayıcılar için geliştirilmiş mevcut entegrasyonların taşınması.
API'nin Yapabilecekleri
1. Anahtar teslimi aktivasyon: numara satın almaktan kodu almaya kadar
Etkinleştirme sürecinin tamamına sezgisel REST uç noktaları üzerinden erişilebilir:
bir hizmet ve ülke seçin, kullanılabilirliği ve fiyatı kontrol edin;
tek bir istekle bir numara satın alın;
alınan SMS'i (veya e-posta aktivasyonu ise e-postayı) alın;
SMS'i tamamlayın, iptal edin veya tekrar gönderilmesini isteyin — durum üzerinde tam kontrol sizdedir.
Her iki ana ürün de desteklenmektedir: SMS alımı (OTP) ve e-posta aktivasyonu. Her aktivasyonun, daha sonra referans olarak kullanabileceğiniz benzersiz bir tanımlayıcısı vardır.
2. Güncel Katalog ve Fiyatlar
API, gerçek zamanlı veriler sağlar:
telefon kodlarını içeren ülke listesi;
hizmetlerin listesi (SMS ve e-posta için);
belirli bir hizmet veya ülke için fiyatlar ile sayfa sayfa sonuçları içeren eksiksiz bir fiyat listesi.
Önemli not: Fiyatlar, kişisel indiriminiz uygulanmış olarak gösterilir. API yanıtında gördüğünüz tutar, bakiyenizden kesilecek tutarın aynısıdır.
3. Webhook'lar: Kodlar Otomatik Olarak Size Ulaşır
SMS mesajlarını beklerken sunucuyu sürekli sorgulamak hem zaman kaybıdır hem de yavaştır. Bu nedenle SMS4You, webhook'lar sunar: yeni bir mesaj gelir gelmez veya aktivasyon durumu değişir değişmez, belirttiğiniz adreslere otomatik olarak bir HTTP isteği göndeririz.
Sorgulama yapmanıza gerek kalmadan olayları anında alırsınız;
Her istek bir HMAC imzasıyla imzalanır, böylece isteğin gerçekten bizden geldiğini doğrulayabilirsiniz;
Sunucunuz geçici olarak erişilemez durumda olursa, yeniden deneme mekanizmaları uyguluyoruz;
Gelen trafiği beyaz listeyle kısıtlayanlar için, webhook'ların gönderildiği IP adreslerinin bir listesini yayınlıyoruz.
REST API ile birlikte bu, entegrasyonu tamamlar: istekleri kendiniz gönderir ve güncellemeleri bir push kanalı üzerinden alırsınız.
4. SMS-Activate ile Uyumluluk: Yeniden Yazmaya Gerek Kalmadan Geçiş
Bu, özellikle gurur duyduğumuz bir konudur. Halihazırda SMS-Activate API'si üzerine kurulmuş bir yazılımınız varsa, entegrasyonunuzu yeniden yazmanıza gerek yoktur. SMS4You, uyumlu bir protokolü destekler: sunucu adresini bizimkiyle değiştirin ve kendi anahtarınızı kullanın.
Mevcut kodunuz, kütüphaneleriniz ve botlarınız olduğu gibi çalışmaya devam edecek, ancak artık SMS4You’in telefon numaraları, fiyatlandırması ve kalitesinden yararlanacaksınız. Bu sayede bize geçiş yapmak, haftalarca süren bir geliştirme süreci yerine, yapılandırma dosyanızda tek bir satırlık bir değişiklik kadar kolay hale gelir.
5. Güvenli ve Basit Kimlik Doğrulama
Komut dosyalarınızda kullanıcı adı veya şifre kullanmanıza gerek yoktur. Hesabınıza giriş yapın, API Jetonları sekmesinde kişisel bir jeton oluşturun ve bunu isteklerinizde kullanın. Jetonu üç farklı şekilde aktarabilirsiniz; kütüphaneniz için en uygun olanı seçin:
başlıkta
Authorization: Bearer <api token>;başlık
X-Api-Token: <api token>;sorgu parametresi olarak
?api_token=<api token>.
Birden fazla token oluşturabilirsiniz (örneğin, her proje için ayrı bir tane) ve güvenliği ihlal edilmiş bir tokeni, diğerlerini etkilemeden istediğiniz zaman iptal edebilirsiniz. Token değeri, oluşturulduğunda yalnızca bir kez görüntülenir; bundan sonra yalnızca siz tarafından saklanır.
6. Uygulamalı belgeler
OpenAPI'ye dayalı etkileşimli bir belgeleme hazırladık: her uç nokta açıklanmış, her alanın türü belirtilmiştir ve bir terminal açmadan doğrudan sayfadan istekler gerçekleştirebilirsiniz. Ayrıca, webhook'lar ve SMS-Activate ile uyumlu protokol hakkında ayrı bir bölüm de bulunmaktadır.
Kılavuza docs.sms4you.org adresinden ulaşabilirsiniz.
Beş dakikada başlayın
Temel API URL'si: https://api.sms4you.org/api/v1
Adım 1. Hesap bakiyenizi ve indiriminizi kontrol edin
curl https://api.sms4you.org/api/v1/me \
-H "Authorization: Bearer YOU TOKEN"
{
"data": {
"name": "Ivan",
"email": "[email protected]",
"email_verified": true,
"balance": "12.3456",
"currency": "USD",
"discount_percent": 5
}
}
Adım 2. İstediğiniz hizmetin fiyatını kontrol edin
curl "https://api.sms4you.org/api/v1/prices?service_id=SERVICE_ID" \
-H "Authorization: Bearer YOU TOKEN"
Adım 3. Bir numara satın alın
curl -X POST https://api.sms4you.org/api/v1/activations \
-H "Authorization: Bearer YOU TOKEN" \
-H "Content-Type: application/json" \
-d '{"service_id": 123, "country_id": 7, "price": "0.20"}'
Yanıtta telefon numarası ve bir aktivasyon kodu yer alacaktır.
Adım 4. Aldığınız SMS'i kontrol edin
curl https://api.sms4you.org/api/v1/activations/{ACTIVATION_ID}/messages \
-H "Authorization: Bearer YOU TOKEN"
Ayrıca, bir webhook kurarsanız bu adımı atlamanız bile gerekmez; kod size otomatik olarak gönderilir.
Sınırlar ve Güvenilirlik
Hizmetin herkes için istikrarlı kalmasını sağlamak amacıyla istek sıklığı sınırlandırılmıştır (varsayılan olarak dakikada en fazla 120 istek).
Hata mesajları da dahil olmak üzere tüm yanıtlar tek tip bir formatta gelir: açık bir kod, insan tarafından okunabilir bir mesaj ve gerekirse ayrıntılar. Bunları kodda işlemek çok kolaydır.
Satın alımlar için doğrulanmış bir e-posta adresi gereklidir; bu, standart bir güvenlik önlemidir.
Bu hizmet kimler içindir
Ürünleri kapsamında SMS mesajları alması gereken geliştiriciler.
Kayıtların sürekli olarak geldiği arbitraj ve pazarlama ekipleri.
Telefon doğrulamasını içeren senaryoları test eden kalite kontrol ekipleri.
Halihazırda SMS-Activate uyumlu yazılım kullanmakta olan ve geçiş sürecinin getireceği zorluklardan kurtulmak isteyen herkes.
Sırada ne var
Halka açık API, üzerinde geliştirmeye devam edeceğimiz temeldir. Taleplerinizi dinleyerek ürün kapsamımızı ve yeteneklerimizi genişletmeyi planlıyoruz. Belirli bir uç nokta veya senaryo eksikliğini hissediyorsanız, destek sohbeti aracılığıyla bize ulaşın: her şeyi okuyoruz ve gerçekten gerekli olanlara öncelik veriyoruz.
Hemen deneyin:
Hesabınıza giriş yapın ve API Tokenleri sekmesinden bir token oluşturun.
docs.sms4you.org adresinden belgelere erişin.
İlk isteğinizi yapın; gerisini otomatikleştirin.
Entegrasyonun keyfini çıkarın ve kodlarınızın zamanında ulaşmasını dileriz.
