Как аутентифицировать запросы?

Pass your access key in a Token header on every request, along with Content-Type: application/json.

Как я узнаю, что сообщение было доставлено?

Every send returns a msgid. Point us at a callback URL and we post a status report to it when the message reaches its final state.

Каков лимит символов в сообщении?

160 characters on GSM7 encoding, or 70 on Unicode. Longer messages are joined from several parts, each billed separately.

Могу ли я получить ответы?

Yes. Inbound replies are delivered to the same callback URL and marked as mobile originated.

Нужна ли мне регистрация DLT в Индии?

Yes. SMS to Indian numbers must use an approved entity, sender header and template. Our team helps you register them during onboarding.

СМС API

Простой REST API для отправка СМС

ОТПРАВЬТЕ отправителя, получателя и контент с заголовком токена. Получите идентификатор сообщения прямо обратно, а отчеты о доставке будут отправлены на ваш сервер.

Начни бесплатно Прочтите документацию

Отправьте свое первое СМС

Один запрос, одно сообщение

Выполните аутентификацию с помощью ключа доступа, отправьте сообщение POST и прочитайте msgid из ответа. Нажмите кнопку, чтобы увидеть, как она запускается.

1curl -X POST https://secure.smslocal.com/api/service/enterprise-service/external/sms \
2  -H "Token: $SMSLOCAL_TOKEN" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "from": "SMSLOCAL",
6    "to": "14155550123",
7    "content": "Your code is 481920."
8  }'

POST/внешний/смс

ПОЧТА/external/sms

Ответ

Запустите запрос, чтобы увидеть ответ.

Создано для разработчиков

Ничего экзотического, чему можно было бы научиться

Три идеи охватывают весь API, который следует простым ОТДЫХ конвенции.

01Аутентификация
Аутентификация токена
Отправляйте ключ доступа в заголовке токена при каждом запросе с входным и выходным JSON.
- SDK не требуется
- Работает с любого языка
- Храните ключ в переменной среды
02Ответ
Знай, что это было принято
Каждая отправка немедленно возвращает msgid и код ошибки.
- Сохраните msgid в своей записи.
- код ошибки 0 означает, что принято
- Используйте msgid для сопоставления отчетов позже
03Ответы
Двусторонняя по умолчанию
Ответы поступают в тот же обратный вызов, помеченный как «Отправлено с мобильного устройства».
- Та же форма сообщения, что и в отчетах
- Укажите направление отдельно с помощью mt/mo.
- Направляйте ответы в свои инструменты поддержки

Отчеты о доставке

Посмотрите, что случилось с каждым сообщением

Отчет о состоянии будет отправлен на ваш URL обратного вызова когда сообщение достигает своего конечного состояния.

1
Соответствие по msgidКаждый отчет содержит идентификатор, который вы получили во время отправки.
2
Только окончательные состоянияВы слышите о сообщении, когда оно доставлено или не удалось.
3
Один URL обратного вызоваОдна и та же конечная точка получает отчеты и ответы.

Журнал доставкиИллюстративный

9f2a7c10+1 415 ••• 0123Доставленныйпрямо сейчас
9f2a7c11+91 98••• 43210Доставленный3 секунды назад
9f2a7c12+44 7••• 123456В ожидании5 секунд назад
9f2a7c13+91 99••• 00012Неуспешный9 секунд назад

Знайте, прежде чем отправлять

Посмотрите, как учитывается сообщение

Более длинный текст и нелатинские символы влияют на то, сколько частей оплачивается в сообщении. Попробуйте свою собственную формулировку и найти номер прежде чем отправить.

Текст сообщения

GSM746 персонажи160 за часть

1частьоплачивается отдельно

Часть 1
46 / 160

Одна часть содержит 160 символов в GSM7 или 70 в Unicode. Один символ, отличный от GSM, например смайлик или буква хинди, переключает все сообщение на Юникод.

Почему API

Перестаньте склеивать сообщения вручную

Перетащите разделитель, чтобы сравнить.

С помощью SMS-API

Сообщения, отправленные с вашего собственного кода
Отчет по каждому сообщению
Ответы отправлены в вашу систему

Без API обмена сообщениями

Ручной экспорт и загрузка
Не знаю, пришло ли сообщение
Ответы попадают в чей-то почтовый ящик.

Прежде чем начать трансляцию

Краткий контрольный список перед запуском

0%0 из 9

Отметьте пункты по ходу дела. Здесь ничего не сохраняется.

01СчетСоздайте учетную запись и скопируйте ключ доступаЗарегистрируйте свой идентификатор отправителяДобавьте URL обратного вызова

02Соответствие (Индия)Зарегистрируйте свою организацию в рамках DLTПолучите одобрение заголовков и шаблоновСоблюдайте часы отправки рекламных материалов

03ТестированиеСначала отправьте на свой номерЗаписывайте каждое полученное сообщениеУбедитесь, что статус сбоя обработан

Продолжайте строить

Больше для вашей интеграции

Забирайте, где бы вы ни находились. Каждый из них основан на одной и той же учетной записи и ключе доступа.

Ответы на ваши вопросы

SMS API — часто задаваемые вопросы

Передавайте ключ доступа в заголовке токена при каждом запросе вместе с типом контента: application/json.

Каждая отправка возвращает msgid. Укажите нам URL-адрес обратного вызова, и мы отправим на него отчет о состоянии, когда сообщение достигнет своего окончательного состояния.

160 символов в кодировке GSM7 или 70 в кодировке Unicode. Более длинные сообщения объединяются из нескольких частей, каждая из которых оплачивается отдельно.

Да. Входящие ответы доставляются на тот же URL-адрес обратного вызова и помечаются как исходящие с мобильного устройства.

Да. Для отправки SMS на индийские номера необходимо использовать утвержденный объект, заголовок отправителя и шаблон. Наша команда поможет вам зарегистрировать их во время онбординга.

Начать

Отправьте свое первое SMS за считанные минуты

Создайте учетную запись, получите ключ доступа и сделайте первый запрос.

Начни бесплатно Посмотреть цены