Buraya başlayın
İlk isteğiniz dört adımda
Bağlantılı mobillerinizi listeleyin ve hedef SID'i kopyalayın.
Bir başlık ve mesaj ile bir bildirim oluşturun.
Liste SID tarafından son noktayı içeriyor.
Dağıtımı izlemek için distribüed status ve GMT zamantamps kullanın.
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.
- 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
BU API İÇİN WEBHOOK V2
Mobil iletişimi sonraki iş adımını tetiklemek için kullanın.
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.
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.receivedSMS alındı
Bağlı bir mobil cihaz gelen bir SMS'u senkronize etti.
call.missedCevapsız çağrı
Bağlı bir mobil cihazdan bir cevapsız çağrı senkronize edildi.
whatsapp.receivedWhatsApp 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
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
- action=preview ile olan sayıların bir göstergesi. request_id gerekli değildir ve kayıtları silinmez.
- Genrate a unique request_id Yeni bir deletion için, örneğin bir UUID. Onu göndermeden önce kurtar action=delete.
- 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.
- 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.
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"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"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.
{
"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
https://api.smsmobileapi.com/notification/sendBir bağlantılı cihaz için içsel bir bildirim oluşturun.
Yönetilen bir telefonda görünmesi gereken operasyonel uyarılar için kullanın.
Parametreler
| Ad | Tür | Gereklilik | Tanı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
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
{
"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 ↑- 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
https://api.smsmobileapi.com/notification/list/En eskisinden sipariş edilen 200 bildirime kadar geri döner.
Dağıtımı izlemek ve bir bildirim tarihi inşa etmek için kullanın.
Parametreler
| Ad | Tür | Gereklilik | Tanı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
curl "https://api.smsmobileapi.com/notification/list/?apikey=YOUR_API_KEY&sidentifiant=TARGET_SIDENTIFIANT&distribued=1"
Örnek yanıt
{
"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 ↑- Tüm gönderilen ve dağıtılmış zamanlar GMT'dir.
POST · GET
Bildirim geçmişini temizle
https://api.smsmobileapi.com/delete-history-notifications/Bu hesapa ait mobiller için bildirim kayıtları. Mobilleri bozmaz.
İ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
| Ad | Tür | Gereklilik | Tanı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
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.
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"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"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
{
"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 ↑- 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.
| HTTP | Kod Kodu Kodu | Ne yapmalı |
|---|---|---|
| 400 | Missing required param | apikey, sid veya mesaj eksik. |
| 400 | Invalid date format | Tarih için YYYY-MM-DDDD'yi kullanın from and date to. |
| 400 | Invalid distribued value | Sadece 0 veya 1 kabul edilir. |
| 500 | DB connection / query failed | Bildirim servisi işlemi tamamlayamadı. |
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.


