REST · JSON · HTTPS

رسائل SMS وOTP وWebhook — عبر REST API واحدة.

أرسل رسائل SMS ورموز OTP من تطبيقك، وجدوِل الإرسال، وأدِر جهات الاتصال؛ واستقبل تقارير التسليم والرسائل الواردة على خادمك عبر Webhook.

افتح التوثيق Swagger UI OpenAPI YAML

العنوان الأساسي https://api.turkeysms.com.tr

نقاط النهاية

ما الذي يمكنك فعله عبر الواجهة

كل نقاط النهاية

إرسال SMS

إرسال فوري أو مجدول إلى رقم واحد أو أكثر؛ وإلى أرقام كثيرة في طلب واحد، بالنص نفسه أو بنص مختلف لكل رقم.

/sms/send/group/send/group/sendMixed

التحقق برمز OTP

تولّد TurkeySMS رمز التحقق؛ أرسله إلى رقم واحد بقالب جاهز، أو باسم المرسل والنص الخاصّين بك.

/otp/send/otp/detailed

Webhook

تصل الأحداث التالية إلى خادمك بطلبات HTTP POST: sms.sent، sms.delivered، sms.failed، sms.received. وعند تعريف secret تُوقَّع الطلبات بـHMAC.

جهات الاتصال وحظر الأرقام

أنشئ المجموعات وأعد تسميتها واحذفها واعرضها، وأضف إليها الأرقام. وأضف أرقاماً إلى قائمة الحظر واستعلم عن حالتها (تُطبَّق القائمة على الإرسال من اللوحة).

/groups/*/contacts/add/blacklist/post/*

الاستعلامات والتقارير

استعلم عن رصيدك وأسماء المرسل وحالة الرسالة؛ واحصل على تقارير الإرسال الموجزة والمفصّلة.

/balance//senderid/check/sms/status/reports/*

مفاتيح API والصلاحيات

تحقّق من مفتاحك؛ وأدِر صلاحيات كل مفتاح في اللوحة من مركز API ← مفاتيحي.

/auth/post/check/

بداية سريعة

طلبك الأول

اكتب مفتاح API واسم مرسل معتمداً، ثم أرسل الطلب. يُرسل المفتاح في الحقل api_key داخل جسم الطلب.

دليل البدء

cURL · POST /sms/send

curl -X POST https://api.turkeysms.com.tr/sms/send \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_API_KEY",
  "title": "YOUR_SENDER",
  "sentto": "905XXXXXXXXX,905YYYYYYYYY",
  "text": "شكراً لتسجيلك في خدمتنا",
  "sms_lang": 2
}'

الاستجابة (مختصرة)200 OK

{
  "result": true,
  "result_code": "TS-1024",
  "result_message": "SMS dispatched successfully.",
  "sms_id": 48213377,
  "number_of_sms": 2,
  "total_recipients": 2,
  "success_count": 2
}

الطلبات تُنفَّذ على النظام الحي

كل طلب يُرسل إلى هذا العنوان يُنفَّذ فعلياً: /sms/send يرسل رسائل SMS حقيقية وتُخصم كلفتها من رصيدك. والطلبات المرسلة من Swagger UI حيّة أيضاً، ولهذا يكون خيار «Try it out» مغلقاً افتراضياً.

أجرِ تجاربك على رقمك أنت، ولا تضع مفتاح API في شيفرة تعمل داخل المتصفح أو في تطبيق جوّال.

HTTPS وPOST وJSON

تُرسل كل الطلبات عبر HTTPS بطريقة POST؛ ويمكن أن يكون جسم الطلب JSON أو بيانات نموذج، والاستجابات بصيغة JSON.

رموز استجابة واضحة

تعود النتيجة ورموز الخطأ (TS-xxxx) في جسم الاستجابة؛ قيّم النتيجة من الجسم لا من رمز HTTP. وكل الرموز في قسم رموز الاستجابة.

OpenAPI 3.1

نزّل المواصفة واستوردها إلى عميل API أو مولّد الشيفرة لديك.

المصادر

التوثيق والأدوات

TRTürkçe dokümantasyon/documentation/turkce ENEnglish documentation/documentation/english عالتوثيق بالعربية/documentation/arabic Swagger UIمرجع API التفاعلي OpenAPI YAML/openapi.yaml · OpenAPI 3.1 لوحة العميلأنشئ مفتاح API من مركز API ← مفاتيحي.