İçeriğe geç
HushSMS

API

Süre ne olursa olsun her hatta ücretsiz. Kurumsal katman yok, kullanıcı başına fiyatlandırma yok ve satış görüşmesi yok.

Temel URL

https://api.hushsms.com

Kimlik doğrulama

Kimlik doğrulama

Hat token'ınızı taşıyıcı kimlik bilgisi olarak iletin. Token'lar tek bir hatla sınırlıdır ve panelden döndürülebilir.

curl https://api.hushsms.com/v1/lines \
  -H "Authorization: Bearer hs_live_..."

Referans

Uç noktalar

GET/v1/lines

Token'ınızdaki hatları listeler. Numara, ülke, süre ve bitiş tarihini döndürür.

POST/v1/lines

Bir hat sağlar. Gövde country, line_type, term ve pool alanlarını alır. Bir kripto faturası döndürür.

GET/v1/lines/{id}/messages

Bir hattaki gelen mesajlar, en yeniden en eskiye. Gövdeler, saklama süresinden sonra silinir.

POST/v1/lines/{id}/messages

Giden SMS gönderir. Her sürede dahildir.

GET/v1/catalog

Canlı ülke stoku, hizmet başına uyumluluk ve güncel fiyatlandırma. Kimlik doğrulama gerektirmez.

DELETE/v1/lines/{id}

Bir hattı erken serbest bırakır. Aylık sürelerde iade yok; altı ay üzerinde orantılı iade.

Push

Webhook'lar

Her gelen mesaj, varıştan sonraki bir saniye içinde uç noktanıza HMAC-SHA256 ile imzalanarak POST edilir.

POST /your-endpoint
X-HushSMS-Signature: sha256=...

{
  "event": "message.received",
  "line_id": "ln_8fQ2...",
  "number": "+44 7700 900123",
  "from":   "+44 7700 900987",
  "body":   "Your code is 481920",
  "received_at": "2026-08-13T09:41:02Z"
}

Makineler

Yapay zeka ajanları için

Makine tarafından okunabilir bir katalog https://hushsms.com/v1/catalog/ adresindedir. Canlı ülke stokunu, hizmet başına uyumluluğu ve güncel fiyatlandırmayı kimlik doğrulama olmadan JSON olarak döndürür.

Open the catalog

Canlı ülke stokunu, çalışmayan hizmetler dahil hizmet başına uyumluluğu, tüm çarpanlarla güncel fiyatlandırmayı ve veri saklama tablosunu döndürür. Anahtar yok, bahsetmeye değer bir hız sınırı yok ve CORS açık. Bir aracı için telefon numarası gerekiyorsa, okumanız gereken uç nokta budur.

Sitenin tamamının düz metin özeti /llms.txt adresinde; tüm derlem /llms-full.txt adresinde.

Katalog, çağrılabilir bir sözleşme olarak

Düz metin derlemi kataloğu okunabilir kılar. Çağrılabilir kılmaz: her kelimeyi okuyan bir aracı yine de istek biçimini, ülke slug'larının listesini veya sunucunun hangi alanları yok saydığını bilmez; bu yüzden satın alamayacağı bir numarayı tanımlayabilir. Bu boşluk, içerik odaklı bir stratejinin durduğu yerdir.

/openapi.json bu boşluğu kapatır — katalogu oku, sipariş oluştur ve sormak için üç genel, kimlik doğrulamasız uç noktayı kapsayan bir OpenAPI 3.1 belgesi; ülke, süre ve havuz listeleri, işleyicilerin doğruladığı katalogdan üretilir. Ayrıca belge başında rel="service-desc" olarak bildirilir; böylece bir hizmet tanımı arayan bir istemci, nereye bakacağı söylenmeden onu bulur.

OpenAPI tanımını aç

Kaynaklar

Bu sayfadaki numaralandırma planı verileri — arama kodu, ulusal numara uzunluğu, şehirlerarası önek ve mobil aralıklar — ITU-T E.164 serisinden alınmıştır. Envanter, fiyatlandırma ve ölçülen başarı oranları bize aittir ve bu şekilde işaretlenmiştir.

Numaralandırma planı doğrulandı

Numara alİletişim