SMS mesajlarınız kendi telefonunuzdan gönderilir.Nasıl çalıştığını öğrenin
PLATFORMFORMFORMAPI-ilk mimarlıkGüvenli cihaz çiftleşiyorTeslimat görünürlüğü görünürlüğüMulti-device kontrolüVersioned documents
Geliştirici merkezi/Bildirim API

PUSH · 3 belgelenmiş işlemler

Bildirim API Belge Belgeleri

Belirli bir bağlantılı mobile iç bildirimleri gönderin ve dağıtım tarihini alın.

Gerçek zamanlı arama ve analiz verileri ile bağlantılı Mobile bildirimleri
REST temel URLhttps://api.smsmobileapi.com

JSON yanıtları · HTTPS gerekli · UTF-8

API anahtarını bağlayın

Bir kez, SMS'deki uç noktaları test edin, aramalar, bildirimler, WhatsApp ve e-posta.

Buraya başlayın

İlk isteğiniz dört adımda

1

Bağlantılı mobillerinizi listeleyin ve hedef SID'i kopyalayın.

2

Bir başlık ve mesaj ile bir bildirim oluşturun.

3

Liste SID tarafından son noktayı içeriyor.

4

Dağıtımı izlemek için distribüed status ve GMT zamantamps kullanın.

Güvenli SMSMobileAPI mobil uygulama bir telefona web paniğe ve REST API'e SMS için bir telefon ve operasyon çağrısı
Şifrelenmiş mobil platform bağlantı bağlantı bağlantı

Resmi mobil uygulama

Telefonunuz, kontrol paneliniz ve API arasındaki güvenli köprü.

SMS ve çağrı işlemleri, bağlı telefonunuza yüklenen resmi SMSMobileAPI uygulaması üzerinden geçer. Uygulama, cihazı güvenli bir şekilde hesabınızla eşleştirir, yetkili etkinlikleri senkronize eder ve mobil ağı kontrol paneline ve REST API'ye bağlar.

1Mobil uygulamaTelefonu ve SIM'ini eşler 2Şifreli bağlantıAktarım halindeki verileri doğrular ve korur 3Kontrol Paneli ve APIİş akışlarını ve etkinliği kontrol eder
  • Resmi Google Play ve Apple App Store listeleri aracılığıyla dağıtılan imzalı sürümler
  • Google ve Apple platform incelemesi, imzalama ve dağıtım kontrolleri
  • Güvenli cihaz eşleştirme, HTTPS aktarımı ve kimlik doğrulamalı API erişimi
  • Yalnızca etkinleştirdiğiniz mobil özellikler için gerekli izinler
Google Play'de resmi SMSMobileAPI uygulamasını alın Apple App Store'da resmi SMSMobileAPI uygulamasını indirin
Yetenekler, Android

BU API İÇİN WEBHOOK V2

Mobil iletişimi sonraki iş adımını tetiklemek için kullanın.

3 olay türü

Bir hedef her şeyi alabilir ya da üretim sistemlerini, analizleri ve operasyonel uyarıları ayırabilirsiniz. Her olayın kesin bir adı vardır, böylece uygulamanız onu öngörülebilir şekilde işleyebilir.

Important

Bildirim API’si bağlı cihazlara bildirim gönderir. Şu anda bildirime özel bir webhook etkinliği yayımlamaz. Bildirim iş akışınızı tetiklemek için alınan SMS, cevapsız arama veya alınan WhatsApp mesajı gibi kaynak etkinlikleri kullanın.

sms.received

SMS alındı

Bağlı bir mobil cihaz gelen bir SMS'u senkronize etti.

call.missed

Cevapsız çağrı

Bağlı bir mobil cihazdan bir cevapsız çağrı senkronize edildi.

whatsapp.received

WhatsApp alındı

Hesap senkronizasyon talep ettikten sonra bir WhatsApp mesajı alındı.

Kimlik doğrulama

Kimlik bilgilerini sunucunuzda tutun

Bildirim uç noktaları apikey parametresini kullanır. Bir hedef telefon, gönderi yaparken ve liste sırasında sid veya yanntifiye tarafından belirlenir.

Tarih Yönetimi

Clear history güvenle: önizleme, silme, ilerleme

Bu uç noktaları, API anahtarınız için seçilen sunucu tarihini, telefonlarda veya dış hizmetlerde mesaj vermemektedir. Hesap süresi sağlamazlar. Yeni aktivite, yıkımdan sonra görünebilir.

request_id ve yeniden deneme rehberi
Bütünleştirici koruma koruma

Varsayılan olarak, bağlantılı veya işleme kayıtları görünür. Sadece sadece sadece kullanım kullanımı kullanın include_linked=1 Bu entegrasyonları kabul ederseniz veya devam eden işleme çalışmayı durdurabilir.

Nasıl istek id çalışır

  1. action=preview ile olan sayıların bir göstergesi. request_id gerekli değildir ve kayıtları silinmez.
  2. Genrate a unique request_id Yeni bir deletion için, örneğin bir UUID. Onu göndermeden önce kurtar action=delete.
  3. Yeniden geziler, zamanlar veya HTTP 202, aynı şeyi tekrarlayın API Anahtar, tarih uç noktası, request_id ve include_linked değer. Bir hatadan sonra otomatik olarak yeni bir kimlik üretmeyin.
  4. Tamamlandığında, operasyon sona erer. ID'sini yeniden kullanmak yeni gelen kayıtları silmenin yerine aynı sonucu döndürür. Sadece kasıtlı olarak yeni bir temizlik için yeni bir kimlik kullanın.

request_id Deletion işleminizi tanımlayın, bireysel bir birey değil SMSİzinli format: 16-128 ASCII mektuplar, basamaklar, hipnozlar veya alt işaretler. A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A UUID Kripto.randomUUID() ile üretilen uygun.

Silme işlemi gruplar halinde yürütülür. HTTP 202 ile continue_required=true dönerse 3 saniye sonra action=delete isteğini tekrarlayın. Arka planda cron çalışmaz. action=status yalnızca ilerlemeyi okur ve HTTP 200 dönse bile silmeyi sürdürmez.

Deletion ve durum örnekleri

Başlangıçta kendi eşsiz değerinizle request_id örneklerini değiştirin. Aşağıdaki silekler gerçek hesap tarihini değiştirir; onlar önizleme değildir.

POST · API anahtar
curl -X POST "https://api.smsmobileapi.com/delete-history-notifications/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST · · OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-notifications/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET · statü durumu
curl -G "https://api.smsmobileapi.com/delete-history-notifications/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

GET Ayrıca kabul de kabul kabul de kabul action=preview veya veya action=delete. POST önerilir: URL parametreleri tarayıcı tarihine ve sunucu loglarına sızdırılabilir. Asla bir halk bağlantı, görüntü veya prefetch'de bir deletion URL'yi yerlemeyin.

POST için, form gövdesinde veya JSON nesnesinde tüm parametreleri gönderin, asla sorgu dizesinde. Bilinmeyen parametreler reddedilir; tarih veya mobil filtreler desteklenmez.

Tarih için kimlik doğrulama son noktaları

Birpikey veya bir Yazarlaşma kullanın: SMSMobileAPI OAuth2 tarafından yayınlanan Ayırma erişim. Bir yenileme token veya bir API anahtarını bir Ayıer token olarak göndermeyin. Açıklamalanmış jetonlar reddedilir.

Alanlar ayarlandığında, history:read önizleme /status ve izin verir history:delete Ayrıca deletion izin verir. Hem token hem de tokenler OAuth müşteri uygulanır. kapsamı olmayan Legacy Jetonlar mevcut hesap erişimlerini korur.

OAuth2 Benzersiz birincil birincil seçin API anahtar. Birkaç birincil anahtar var ise, aynı zamanda da sağlar apikey Hesabına ait birini seçmek. Orta anahtarlar asla birincil anahtar tarihine erişmez.

Devam etmeden önce cevabı okuyun

count delete bu operasyon tarafından kaldırıldı. Seçilen at start ilk seçimdir; protected at start dışlanmış kayıtlardır. Bağlantılı kayıtları saymak için önbellek kullanma işlemini, linked=1 dahil olduğunda bile.

JSON · · HTTP 202
{
    "result": {
        "error": 0,
        "history": "notifications",
        "action": "delete",
        "request_id": "6d54ac58-41f1-4fbc-9a39-6e6c86089451",
        "status": "processing",
        "completed": false,
        "count_delete": 100,
        "total_before": 250,
        "selected_at_start": 200,
        "protected_at_start": 50,
        "include_linked": 0,
        "continue_required": true,
        "message": "Repeat GET or POST with the same request_id and include_linked to continue. Status requests do not run deletion."
    }
}
  • completed=true ile 200: bit. Sadece 200 önizleme veya durum yanıtı tamamlanmamıştır.
  • 400 INVALID REQUEST ID: formatı kontrol edin. 404 REQUEST NOT FOUND: Bu ID için hiçbir operasyon mevcut değildir, API anahtar ve tarih.
  • 401: geçersiz veya süresiz kimlikler. 403: yetersiz OAuth kapsamı veya yetkisiz hesabı.
  • 409 HISTORY_BUSY: Başka bir temizlik çalışır; orijinal müşteriden devam edin. 409 INCLUDE_LINKED_CONFLICT: Orijinal include_linked değerini geri yükleyin.
  • 409 OAUTH_ACCOUNT_AMBIGUOUS: Bir an için API Bu hesaba ait anahtar.
  • 503 veya ağ kesintisi: Bazı partiler zaten tamamlanmış olabilir. Kontrol konfigürasyonu, sonra orijinal ile yeniden başa çıkmak request_id. Geçici bir işlem otomatik olarak yaratmaz.
POST · GET

Bir bildirim gönder

#
ENDPOINThttps://api.smsmobileapi.com/notification/send

Bir bağlantılı cihaz için içsel bir bildirim oluşturun.

Ne zaman kullanılmalı

Yönetilen bir telefonda görünmesi gereken operasyonel uyarılar için kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli API anahtarınız.
sid dize Gerekli Hedef mobil SID.
title dize Seçmeli Bildirim başlığı; Bildirime varsayılan varsayılanlar.
message dize Gerekli Bildirim içeriği.
type dize Seçmeli Bildirim türü; bildirime varsayılanler.

Örneğin

kıvrımlı
curl -X POST "https://api.smsmobileapi.com/notification/send" \
  -d "apikey=YOUR_API_KEY" \
  -d "sid=TARGET_SIDENTIFIANT" \
  --data-urlencode "title=Order ready" \
  --data-urlencode "message=Order #1042 is ready for collection."

Örnek yanıt

JSON
{
  "success": true,
  "message": "Notification created.",
  "id": 22087,
  "apikey": "YOUR_API_KEY",
  "sid": "508b004b4aadacc4"
}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
İyi bilmek
  • Yaratılış ve dağıtım ayrı olaylardır. Cihazın teslimini doğrulamak için liste uç noktası kullanın.
ELDE ETMEK

Liste bildirimleri listesi

#
ENDPOINThttps://api.smsmobileapi.com/notification/list/

En eskisinden sipariş edilen 200 bildirime kadar geri döner.

Ne zaman kullanılmalı

Dağıtımı izlemek ve bir bildirim tarihi inşa etmek için kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli API anahtarınız.
sidentifiant dize Seçmeli Filtre mobil hedefle.
sid dize Seçmeli Alias of sidentifiant.
distribued 0 | 1 Seçmeli Dağıtıldıysa 1, dağıtılmadıysa 0.
date_from YYYYYY-MM-DDD Seçmeli Başlangıç tarihi.
date_to YYYYYY-MM-DDD Seçmeli Son tarih.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/notification/list/?apikey=YOUR_API_KEY&sidentifiant=TARGET_SIDENTIFIANT&distribued=1"

Örnek yanıt

JSON
{
  "success": true,
  "count": 1,
  "data": [{
    "sidentifiant": "508b004b4aadacc4",
    "title": "Order ready",
    "message": "Order #1042 is ready for collection.",
    "distribued": "1",
    "distribued_status": "distributed",
    "distributed_at_gmt": "2026-03-18 10:18:30",
    "distributed_at_unix": 1773829110,
    "sent_at_gmt": "2026-03-18 10:15:03",
    "sent_at_unix": 1773828903
  }]
}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
İyi bilmek
  • Tüm gönderilen ve dağıtılmış zamanlar GMT'dir.
POST · GET

Bildirim geçmişini temizle

#
ENDPOINThttps://api.smsmobileapi.com/delete-history-notifications/

Bu hesapa ait mobiller için bildirim kayıtları. Mobilleri bozmaz.

Ne zaman kullanılmalı

İlk önce önizleme kullanın, sayıları kontrol edin, sonra açıkça istek delesyon. Bu, seçilen tüm tarihi açıklar API Anahtar, tarih olmadan, telefon veya mesaj filtreleri.

Parametreler

AdTürGereklilikTanım
apikey dize Seçmeli Gerekli olmadan Gerekli OAuth2. with . with OAuth2, Seçmeli olarak bir an seçin API Aynı hesaba ait anahtar.
action Tanıtım | silin | durum Seçmeli preview silmeden sayar; delete silmeyi başlatır veya sürdürür; status yalnızca ilerlemeyi gösterir. API varsayılanı delete, bu test aracının varsayılanı preview değeridir.
include_linked 0 | 1 Seçmeli Varsayılan 0: Bağlantılı veya işleme kayıtlarını tut. Onları içerecek 1 set, kırılma entegrasyonları riski ile. Bu değeri bir delesyon devam ederken değişmeden tutun.
request_id dize Seçmeli delete ve status için zorunlu, preview için isteğe bağlıdır. 16–128 ASCII harfi, rakam, kısa çizgi (-) veya alt çizgi (_) kullanın. Her yeni silme işlemi için benzersiz bir ID oluşturun ve tüm yeniden denemelerde aynı ID’yi koruyun. Bu bir mesaj ID’si veya API anahtarı değildir.

Örneğin

kıvrımlı
curl -X POST "https://api.smsmobileapi.com/delete-history-notifications/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=preview" -d "include_linked=0"
Deletion ve durum örnekleri

Başlangıçta kendi eşsiz değerinizle request_id örneklerini değiştirin. Aşağıdaki silekler gerçek hesap tarihini değiştirir; onlar önizleme değildir.

POST · API anahtar
curl -X POST "https://api.smsmobileapi.com/delete-history-notifications/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST · · OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-notifications/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET · statü durumu
curl -G "https://api.smsmobileapi.com/delete-history-notifications/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

Örnek yanıt

JSON
{
    "result": {
        "error": 0,
        "history": "notifications",
        "action": "preview",
        "total": 120,
        "simple": 100,
        "linked_or_processing": 20,
        "selected": 100,
        "include_linked": 0,
        "operation_in_progress": false,
        "active_include_linked": null
    }
}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
İyi bilmek
  • Yukarıdaki örnek bir önbellek değil, bir deletion. Kontlar açıklayıcıdır; kesin seçim, yıkım başladığında sabitlenir.
  • include_linked=1 Bu kesintiyi bozabilir GHL, Zapier, otomasyonlar, Ücretli bağlantılar veya teslimat izleme. Asla hesap mülkiyeti veya depolama bütünlüğü kontrollerini atlamıyor.

Sorun giderme

Hatalar ve güvenli yenidenrries

HTTP statüsünü ve JSON hata alanını yeniden denemeden önce okuyun. İstekyi ilk önce düzeltmeden doğrulama veya doğrulama başarısızlıklarını yeniden denemeyin.

HTTPKod Kodu KoduNe yapmalı
400Missing required paramapikey, sid veya mesaj eksik.
400Invalid date formatTarih için YYYY-MM-DDDD'yi kullanın from and date to.
400Invalid distribued valueSadece 0 veya 1 kabul edilir.
500DB connection / query failedBildirim servisi işlemi tamamlayamadı.
Yeniden deneme kuralıYeniden deneme sadece 429 ve 5xx yanıtlarını geçici olarak yeniden deneyin. 1 saniye sonra, sonra 2, 4 ve 8 saniyeye kadar geri başlayın.

Yardıma mı ihtiyacınız var?

İstek bağlamını getir - sırlarınız değil.

Son noktayı paylaşın, zamantamp, HTTP durumu ve sanitized yanıt. API anahtarlarını, jetonları veya özel mesaj içeriğini asla dahil etmeyin.

İletişim API destek