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/SMS API API

SMS · 16 belgelenmiş işlemler

SMS API Belge

SMS gönderin, teslimat günlüklerini kontrol edin, konuşmaları inşa edin ve bağlantılı mobil ağ geçidi yönetin.

SMS ve bulut ağ geçidi altyapısına bağlı bir akıllı telefon
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

Bir hesap oluşturun ve API anahtarını panodan kopyalayın.

2

Mobil uygulamayı yükleyin ve cihazın online olduğunu doğrulayın.

3

/sendsms / son nokta ile bir test SMS gönderin.

4

Mağaza, günlükleri ve teslimat durumunu ilişkilendirecek mesaj ID'sini geri döndürür.

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

İş akışınızın ihtiyaç duyduğu mobil olaylara abone olun.

5 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.

sms.api.submitted

SMS API üzerinden gönderim talebi oluşturuldu

API isteği bir SMS gönderme işi oluşturdu. İsteğin platforma girdiğini onaylamak için yararlıdır.

sms.sent

SMS gönderildi

Bağlı mobil cihaz, SMS gönderme işlemini onayladı.

sms.failed

SMS başarısız oldu

Bağlı mobil cihaz bir SMS gönderme hatası döndürdü.

sms.received

SMS alındı

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

sms.mobile.sent

SMS mobil cihazdan gönderildi

Bağlı mobil cihazdan manuel olarak bir SMS gönderildi.

Kimlik doğrulama

Kimlik bilgilerini sunucunuzda tutun

Her istek bir API anahtarını apikey parametresi aracılığıyla kabul eder. OAuth2 müşteri kimlikleri de sunucu-server entegrasyonları için mevcuttur. Tarayıcı kodunda asla bir üretim anahtarı, halk havuzu veya destek mesajları açığa çıkarma.

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-sms-api/" \
  --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-sms-api/" \
  -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-sms-api/" \
  --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": "sms-api",
        "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 SMS gönder

#
ENDPOINThttps://api.smsmobileapi.com/sendsms/

Queues, bağlantılı bir telefonda bir mesaj. POST, mesaj uzun olduğunda veya özel karakterler içerdiğinde tavsiye edilir.

Ne zaman kullanılmalı

Bu işlemi mesajları, hatırlatmalar, uyarılar ve uygulama-dönüşüm SMS için kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
recipients telefon telefon telefon telefon telefon telefon telefon telefon Gerekli Uluslararası formatta destinasyon numarası.
message dize Gerekli Mesaj gövdesi. URL-encode it when using GET.
port 1 | 2 Seçmeli Android cihazları ile uyumlu SIM port; otomatik seçim için boş bırakın.
sIdentifiant dize Seçmeli Özel bağlantılı telefon SID; ilk mevcut cihaz için boş bırakın.
shorturl 0 | 1 Seçmeli Mesajda bulunan 1'e kısa URL'lere ayarlayın.
sendsms 0 | 1 Seçmeli SMS kanalı bayrağı. Öldüğünde 1'e kadar sıralayın.
sendwa 0 | 1 Seçmeli Ayrıca, hesabın desteklediğinde WhatsApp teslimatını da talep edin.
encrypt_message Evet Seçmeli Alıcının koruması altındaki okuma mesajı şifreleyin.
schedule_timestamp Unix saniye Seçmeli Mesajın gönderildiği UTC zamanı.

Örneğin

kıvrımlı
curl -X POST "https://api.smsmobileapi.com/sendsms/" \
  -d "apikey=YOUR_API_KEY" \
  -d "recipients=+1234567890" \
  --data-urlencode "message=Your appointment is confirmed for tomorrow."

Örnek yanıt

JSON
{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25",
    "note": "sent by mobile",
    "datetime": "2026-03-20T21:07:44Z",
    "port": null,
    "send_with_whatsapp": "0"
  }
}

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
  • Başarılı bir API yanıt, mesaj platformu tarafından kabul edildi; daha sonra takip için geri dönüş boş tutmayı sağlar.
  • Taşıyıcı teslimat ve mobil işleme HTTP yanıtından sonra olabilir.
POST · GET

Gönderilmemiş bir SMS'i yeniden gönder

#
ENDPOINThttps://api.smsmobileapi.com/resend/

Şu anda bir hata durumunda olan bir mesaj yeniden yaz.

Ne zaman kullanılmalı

Gönderilen logu kontrol ettikten sonra bunu kullanın ve başarısız bir mesajın başka bir girişim için uygun olduğunu doğrulayın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
guid dize Gerekli Mesaj GUID gönderi veya log uç noktası tarafından geri döndü.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE"

Örnek yanıt

JSON
{
  "result": {
    "error": "0",
    "sms": "resent with successfully",
    "attempt": 1
  }
}

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
  • Yalnızca bir hata statüsü ile mesajlar kızgın olabilir.
ELDE ETMEK

Liste SMS API'den gönderildi

#
ENDPOINThttps://api.smsmobileapi.com/log/sent/sms/

SMS API aracılığıyla gönderilen mesajlar sıra, mobil ve hata bilgileri ile gönderilir.

Ne zaman kullanılmalı

Teslimat izleme, tanı ve uzlaşma için kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
guid_message dize Seçmeli eşsiz GUID tarafından bir mesaj döndürür.
before Zamanlar veya referanslar Seçmeli Verilen cursor veya zamantamp öncesinde mesajlar döndürür.
error_api 0 | 1 Seçmeli API işleme hataları sadece geri dönmek için 1'e ayarlayın.
error_mobile 0 | 1 Seçmeli Mobil gönderme hataları sadece 1'e kadar ayarlayın.
keyword dize Seçmeli Alıcı numarası veya mesaj metni arayın.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/log/sent/sms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

Örnek yanıt

JSON
{
  "result": {
    "error": "0",
    "sms": [{
      "sIdentifiantPhone": "508b004b4aadacc4",
      "recipients": "+1234567890",
      "sms": "Test message",
      "guid_message": "MESSAGE_GUID",
      "send_from_mobile": 1,
      "error_api": "",
      "send_from_mobile_erreur": ""
    }]
  }
}

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 ↑
ELDE ETMEK

Liste SMS bir telefondan senkronize edildi

#
ENDPOINThttps://api.smsmobileapi.com/log/sent/frommobile/

Listeler SMS fiziksel olarak bir mobil tarafından gönderilir ve platformla senkronize edilir.

Ne zaman kullanılmalı

Mesajların telefonda API aracılığıyla kaynaklandığı zaman kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
date YYYYYY-MM-DDD Seçmeli Filtre tam bir tarih.
date_from YYYYYY-MM-DDD Seçmeli Bir tarih aralığından başlayın.
date_to YYYYYY-MM-DDD Seçmeli Bir tarih aralığının sonu.
period Enum Seçmeli Bugün, dün, son 24h, son 3 gün veya son 7 gün.
number telefon telefon telefon telefon telefon telefon telefon telefon Seçmeli Alıcı tarafından filtre.
sIdentifiant dize Seçmeli Bağlantılı mobil SID tarafından filtre.
message dize Seçmeli Mesaj içeriğine göre filtre.
search dize Seçmeli Mobil, sayı, mesaj ve zaman notamps'ta Global arama.
sort_by Enum Seçmeli sIdentifiant, sayı, mesaj, mobil date ms, mobile date formatted veya senkronizasyon time.
sort_order ASC | DESC Seçmeli Sort yönü.
limit Tamsa Seçmeli En fazla 200 kayıt.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&period=last_7days&limit=200"

Örnek yanıt

JSON
{
  "result": {
    "error": "0",
    "count": 1,
    "history_limit_days": 7,
    "sms": [{
      "sIdentifiant": "508b004b4aadacc4",
      "number": "+15551234567",
      "message": "Appointment confirmed.",
      "mobile_date_ms": 1774041004692,
      "synchro_time": "2026-03-20 21:10:05"
    }]
  }
}

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
  • Android uygulaması 4.1.20 veya yeni ve uygulamada etkinleştirilmelidir.
  • Bu uç nokta, senkronize tarihinin en fazla yedi günü döndürür.
ELDE ETMEK

Liste alındı SMS

#
ENDPOINThttps://api.smsmobileapi.com/getsms/

Gelen SMS, bağlı telefonlardan senkronize edilir.

Ne zaman kullanılmalı

Bir kutu inşa etmek, yanıt için anket veya webhook kesintiden sonra mesajları kurtarmak için kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
sIdentifiantPhone dize Seçmeli SMS aldıran telefon tarafından filtre.
after_timestamp_unix Unix saniye Seçmeli Bu zamantamp'tan sonra alınan mesajlar.
onlyunread Evet Seçmeli API eyaletinde okunmuş gibi işaretlenme yalnızca mesajlar döndürür.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY&onlyunread=yes"

Örnek yanıt

JSON
{
  "result": {
    "error": "",
    "sms": [{
      "id": 466340,
      "sIdentifiantPhone": "508b004b4aadacc4",
      "timestamp_unix": 1774041814,
      "message": "Please call us back.",
      "number": "+15551234567",
      "guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
      "alias": 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 ↑
POST · GET

Mark a receive SMS as read

#
ENDPOINThttps://api.smsmobileapi.com/getsms/set-read/

Marks biri SMSMobileAPI API eyaletinde okunmuş gibi mesaj aldı.

Ne zaman kullanılmalı

Uygulamanızın bir gelen mesajı işledikten sonra bunu kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
guid_message dize Gerekli Alınan SMS'in GUID'si.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

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
  • Bu, telefon mesajlaşma uygulamasına dahil edilen raporu değiştirmiyor.
POST · GET

Güncelleme: Kabul edilen bir SMS alias

#
ENDPOINThttps://api.smsmobileapi.com/getsms/update/

Alınan bir SMS ile ilişkili olan aliasları ekleyin.

Ne zaman kullanılmalı

Bir bağlantı adı veya uygulama etiketi bir mesaja eklemek için biralar kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
guid dize Gerekli Alınan SMS'in GUID'si.
alias dize Gerekli Yeni bir alias. Bunu temizlemek için boş bir değer gönderin.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID&alias=John%20Doe"

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 ↑
POST · GET

Delete SMS sunucusu logları

#
ENDPOINThttps://api.smsmobileapi.com/deletesms/

SMSMobileAPI sunucu loglarından gelen SMS kayıtlarını bırakın.

Ne zaman kullanılmalı

Belirli bir giriş mesajının tutulması veya kaldırılması için kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
guid_message dize Seçmeli GUID tarafından bir mesaj.
date_start YYYYYY-MM-DDD Seçmeli Bu tarihten kayıtları sil.
date_end YYYYYY-MM-DDD Seçmeli Tarih start ile, deletion aralığı sınırları.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

Örnek yanıt

JSON
{
  "result": {
    "error": null,
    "count_delete": 1
  }
}

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
  • Bu silinler sunucu girişleri sadece. Mobil cihazda saklanan mesajları silmiyor.
  • Bu işlemi, aramadan önce yıkıcı ve doğru filtreler olarak ele alın.
ELDE ETMEK

Liste SMS konuşmaları

#
ENDPOINThttps://api.smsmobileapi.com/conversation/sms/list/

Gruplar gelen ve giden mesajlar telefon numarasıyla konuşmaları.

Ne zaman kullanılmalı

Sohbet görüşleri için kullanın, son konuşma pencereleri ve zaman çizelgesi destekler.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
origineConversation alındı | gönderildi Gerekli Dataset başlangıç konuşmaları tanımlamak için kullanılır.
numero telefon telefon telefon telefon telefon telefon telefon telefon Seçmeli Bir telefon numarası sohbetine dön.
date_from Tarih veya Tarih Seçmeli Mesaj aralığından başlayın.
date_to Tarih veya Tarih Seçmeli Mesaj aralığının sonu.
sort ASC | DESC Seçmeli Konuşma emri; varsayılan DESC.
limit Tamsa Seçmeli Konuşma sınırı, numero'nun ihmal edildiği zaman; varsayılan 20.
resume 0 | 1 Seçmeli Konuşmadaki son mesajları geri getirmek için 1'e ayarlayın.
resume_line_how Tamsa Seçmeli özgeçmiş =1'de konuşma başına mesaj sayısı.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&resume=1&resume_line_how=3"

Örnek yanıt

JSON
{
  "success": true,
  "origineConversation": "received",
  "conversations": [{
    "phone_number": "+15551234567",
    "contact_alias": "John Doe",
    "messages": [{
      "direction": "incoming",
      "message_id": "msg_1001",
      "timestamp_utc": "2026-03-13T08:45:12Z",
      "message": "I need more information.",
      "status": "received",
      "mobile_sid": "device_sid_1"
    }]
  }]
}

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 ↑
ELDE ETMEK

Liste bağlantılı mobiller

#
ENDPOINThttps://api.smsmobileapi.com/gateway/mobile/list/

SMS ağ geçidi hesabına bağlı telefonlar listeler.

Ne zaman kullanılmalı

Bir gönderici seçmek için kullanın, ekran cihazı statüsü veya bir ağ geçidi filosunu denetlemek.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
sid dize Seçmeli Tam bir mobil SID'ye dön.
search dize Seçmeli Arama SID, tarih, batarya, sürüm, etiket ve ilgili alanlarda.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/gateway/mobile/list/?apikey=YOUR_API_KEY"

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 ↑
POST · GET

Bağlantılı bir mobil güncelleştirme

#
ENDPOINThttps://api.smsmobileapi.com/gateway/mobile/update/

İnsan hazırlanabilir etiket veya telefon numarasını bağlantılı bir cihazın Güncellemeleri.

Ne zaman kullanılmalı

Cihazı çok telefon yüklemelerinde anlamlı tutmak için kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
sid dize Gerekli Cihaz SID.
label dize Gerekli Yeni etiket; kasıtlı olarak boş olabilir.
phone_number telefon telefon telefon telefon telefon telefon telefon telefon Seçmeli Yeni telefon numarası metadata.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/gateway/mobile/update/?apikey=YOUR_API_KEY&sid=DEVICE_SID&label=OfficePhone"

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 ↑
POST · GET

Bir bağlantılı mobil

#
ENDPOINThttps://api.smsmobileapi.com/gateway/mobile/delete/

Bağımlı bir mobil ve ağ geçidi tarih sıralarını kaldırır.

Ne zaman kullanılmalı

Sadece bir telefon hesabından kalıcı olarak kaldırıldığında kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli Hesabınız API anahtarı.
sid dize Gerekli Cihazın SID'i kaldırmak için.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/gateway/mobile/delete/?apikey=YOUR_API_KEY&sid=DEVICE_SID"

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
  • Bu işlem SID ile ilişkili cihaz tarihini ortadan kaldırır. Cihazı aramadan önce onaylayın.
INBOUND POSTT

SMS'i webhook tarafından alın

#
HEDEF HEDEF HEDEF HEDEF HEDEFYour HTTPS endpoint

SMSMobileAPI, bir SMS alındığında yapılandırılan yapılandırılmış URL'nize bir JSON istek gönderir.

Ne zaman kullanılmalı

Sık anket yerine gerçek zamanlı işleme için webhooks kullanın.

Alıcı örneği

PHP 8 PHP 8
<?php
$payload = json_decode(file_get_contents('php://input'), true);
if (!is_array($payload) || empty($payload['guid'])) {
    http_response_code(400);
    exit('Invalid payload');
}
// Queue the event, then acknowledge quickly.
http_response_code(200);
echo 'OK';

Örnek yanıt

JSON
{
  "date": "2026-03-20",
  "hour": "10:15:00",
  "time_received": "2026-03-20 10:14:50",
  "message": "Hello, this is a test.",
  "number": "+123456789",
  "guid": "abcde12345"
}
Inbound endpoint

Bu uç nokta kendi HTTPS URL'nizde olayları alır. Yukarıdaki alıcı örneği kullanın, sonra test etmek için bağlı telefonunuza bir SMS gönderin.

İyi bilmek
  • Dashboard'daki halka açık HTTPS URL'yi yapılandırın → Webhook Ayarları.
  • HTTP 200 hızlı bir şekilde geri dönün ve olayı bir şekilde işlemeyi.
  • Gerid kullanarak yeniden birleşmeler.
POST · GET

API ile gönderilen SMS geçmişini temizle

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

Clears server kayıtlarının SMS Gönderilenler aracılığıyla APIBir telefon tarafından zaten toplanan bir mesajı hatırlamıyor.

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-sms-api/" \
  --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-sms-api/" \
  --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-sms-api/" \
  -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-sms-api/" \
  --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": "sms-api",
        "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.
POST · GET

Mobilden gönderilen SMS geçmişini temizle

#
ENDPOINThttps://api.smsmobileapi.com/delete-history-sms-mobile/

Clears senkroniz kayıtlarının SMS Mobillerden gönderilen mesajlar telefonda saklanan mesajlar değil.

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-sms-mobile/" \
  --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-sms-mobile/" \
  --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-sms-mobile/" \
  -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-sms-mobile/" \
  --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": "sms-mobile",
        "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.
POST · GET

Alınan SMS geçmişini temizle

#
ENDPOINThttps://api.smsmobileapi.com/delete-history-sms-received/

Gelen SMS'in sunucu kayıtlarını açın. Entegrasyon ve otomasyon kayıtları varsayılan olarak korunmaktadır.

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-sms-received/" \
  --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-sms-received/" \
  --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-sms-received/" \
  -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-sms-received/" \
  --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": "sms-received",
        "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_parameterGerekli bir parametre boş veya yok. Son nokta için parametre masasına göz atın.
403invalid_apikeyAPI anahtarı bilinmemektedir, süresiz veya talep edilen özellik için yetkili değildir.
429too_many_requestsİstekler çok hızlı geliyor. Bekle, sonra üst üste tekrar tekrarla.
500server_errorHizmet isteği tamamlayamadı. Devam ederse yanıt ve iletişim desteği tutun.
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