Güvenilir SMS entegrasyonu; katalog sorgusunu, kullanıcıya bağlı teklifi, idempotent sipariş oluşturmayı, durum okumayı ve onaylı iptali ayırır. Sağlayıcı anahtarlarını sunucuda tutun ve her istekte sahipliği kontrol edin. Belirsiz sağlayıcı yanıtında yeniden satın almak veya onaysız iade yerine durumu uzlaştırmak gerekir.
İstemci arayüzünü sağlayıcı erişiminden ayırın
Tarayıcı uygulamanızın API'sine istek göndermeli; SMS sağlayıcısını sunucu çağırmalıdır. Anahtarları runtime secrets alanında saklayın ve yalnızca giriş yapmış kullanıcının gereken sipariş alanlarını döndürün. Herkese açık katalog, özel hesap veya gelen kutusundan farklıdır. Durum sorgulama, iptal ve tamamlama dahil her sipariş işleminde sahiplik kontrol edin. Yalnızca satın alma rotasında kimlik doğrulama yeterli değildir.
Kısa süreli teklifi fiyatın yetkili kaynağı yapın
ReceiveSMSGo'te yazılan POST /api/v1/quotes, 60 saniye geçerli kullanıcıya bağlı teklif oluşturur. Sunucu USD fiyatını max($0.39, dönüştürülmüş sağlayıcı maliyeti × 2) olarak hesaplar. Sipariş oluştururken istemci güvenilen fiyat değil teklif kimliği gönderir. Süre dolarsa yeni teklif isteyin. Stok sorguyla satın alma arasında bitebilir; kullanılabilirlik hatalarını açıkça gösterin.
Bir kez rezervasyon yapın, belirsiz alımları uzlaştırın
POST /api/v1/orders, Idempotency-Key ve quoteId gerektirir. Aynı amaçlanan işlem için aynı anahtarın yeniden kullanılması mevcut siparişi döndürür. Yazılan cüzdan rezervasyonu ve ledger güncellemesi atomiktir. Sağlayıcı satın alma yanıtı belirsizse sipariş otomatik tekrar alım yerine incelemeye geçer. Idempotency uygulama sınırınızı korur; sağlayıcıdaki zaman aşımını kendiliğinden uzlaştırmaz.
- Amaçlanan tek alım için bir anahtar oluşturup yeniden denemelerde saklayın.
- Güncel teklif kimliğini giriş yapmış kullanıcı bağlamıyla gönderin.
- Başka satın alımdan önce belirsiz sonuçları uzlaştırın.
Sağlayıcıyı zorlamadan sahip olunan siparişi sorgulayın
GET /api/v1/orders/{id}, kullanıcının siparişini döndürür ve aktif sağlayıcı durumunu yenileyebilir. Uygulama her siparişte sağlayıcı kontrolünü en fazla beş saniyede bire sınırlar. Bekliyor, mesaj alındı, tamamlandı, iptal edildi, süresi doldu ve incelemede durumlarını ayrı modelleyin. Sağlayıcı belgesinde birimler belirsizse bitiş saati uydurmayın. Tarayıcının kapanması uzak siparişin bittiği anlamına gelmez.
Bakiyeyi değiştirmeden iptali onaylatın
POST /api/v1/orders/{id}, cancel veya finish işlemlerini kabul eder. Oluşturmadan sonra 120 saniye iptal kapalıdır; sonrasında sunucu tek iadeden önce sağlayıcı iptalini ister. Tamamlama için alınmış SMS kodu gerekir. Eşzamanlı işlemler çakışmayı önleyen durum geçişleri kullanır. Başarısız ağ isteği ne başarılı iptal ne de ikinci kez bakiye ekleme izni sayılmalıdır.
Callback doğrulayın, kodla operasyonel hazırlığı ayırın
Gelen bir bildirim kendiliğinden güvenilir sayılmaz. Stripe imzası doğrulandıktan sonra bakiye eklenmeden önce ödeme kaydı yetkili API'den sorgulanır. İmzasız SMS durum bildirimi, kimlik doğrulamalı sipariş durumu sorgulaması için yalnızca bir işarettir. Stripe test ve canlı olayları kendi uç nokta sırrı, hesabı ve yükleme ortamıyla eşleşmelidir. Dış bildirimlerin ulaşabilir olması gerekir; yönlendirme ödeme kanıtı değildir. Çalışma alanı API'leri herkese açık geliştirici API anahtarı değil, kimlik doğrulamalı site oturumu gerektirir. Entegrasyondan önce etkin işlemleri ve OpenAPI'yi inceleyin.
Yararlı sorular, net cevaplar
Sağlayıcı API anahtarını frontend koduna koyabilir miyim?
Hayır. Sunucu runtime secrets alanında tutun. Frontend, kullanıcının doğrulanmış bağlamıyla kendi API'nizi çağırmalıdır.
Zaman aşımına uğrayan alımı yeni anahtarla denemeli miyim?
Önce ilk siparişi sorgulayıp uzlaştırın. Yeni anahtar başka bir satın alma anlamına gelir ve başka ücret oluşturabilir.
Çalışma alanı API'si public geliştirici anahtarı ürünü mü?
Hayır. Sipariş ve hesap API'leri site giriş oturumunu gerektirir. Ayrı public geliştirici anahtarı ürünü henüz yoktur; entegrasyondan önce etkin işlemleri inceleyin.
Kaynaklar ve ek okumalar
Kaynaklar kendi hizmetlerini açıklar ve değişebilir. Numara seçmeden önce hedef hizmetin güncel koşullarını kontrol edin.
Başlamadan önce akışı anlayın.
Çalışma alanında hizmet seçimini, ülke seçeneklerini ve SMS durumunu keşfedin. Teklifler ve stok sağlayıcıya bağlıdır; numara kabulü ve teslimat garanti edilmez. Cüzdanınız ve siparişleriniz giriş gerektirir.
Çalışma alanını aç
