Pinc0dE

Самый простой способ добавить в приложение
аутентификацию любых процессов через смс.


Pinc<span>0</span>dE

Инструкции

Основная работа с сервисом выполняется через API и сводится к отправке двух запросов.

Для создания пинкода:

POST 'http://pinc0de.com/api/v1/pins',
     id: $id,
     message: $message,
     phone: $phone,
     attempts: $attempts,
     expire: $expire,
     sender: $sender_params,
     api_key: $api_key

И для его проверки:

GET 'http://pinc0de.com/api/v1/pins/$id/check',
    code: $code,
    api_key: $api_key

В обоих случаях при успехе сервер вернет 200-ый статус и 403 при ошибке.

Расшифровка параметров

  • id - уникальный идентификатор, который генерируется на вашей стороне. Например: "session322".
  • message - текст сообщения. Впишите {{pin}} в то место, где должен отображаться код. Например: "Ваш пин - {{pin}}".
  • phone - телефон в международном формате без специальных символов. Например: "79069745081".
  • attempts - количество попыток на ввод. Не больше ста.
  • expire - время жизни пинкода в секунтах. Не больше 6000 секунд.
  • sender - данные смс-шлюза. Подробнее в следующей главе.
  • api_key - ключ доступа.

В запросе обязательно передавать все параметры.

Отправка сообщения

СМСки отправляются через ваш шлюз. Параметры передаются в запросе на создание пинкода.

sender: {
  geatway: 'Sms::Clickatell',
  clickatell_key: $CLICKATELL_KEY,
  name: $COMPANY_NAME
}
sender: { geatway: 'Sms::Smsru', smsru_api_id: $YOUR_KEY }
sender: {
  geatway: 'Sms::Nexmo',
  nexmo_key: $NEXMO_KEY,
  nexmo_sekret: $NEXMO_SEKRET
}
sender: {
  geatway: 'Sms::SmsUslugi',
  sms_uslugi_login: $SMS_USLIGU_KEY,
  sms_uslugi_pwd: $SMS_USLIGU_PWD
}

Если вы хотите отправлять сообщения через шлюз, которого нет в списке, то сообщите об этом и все будет ок.

Стоимость

Первый год сервис работает бесплатно, если проект отправляет менее 3000 запросов в день.

Никаких таблиц цен у нас нет, если хотите использовать сервис в промышленных масштабах, то пишите на почту.

ОпенСорс

Проект разработан на основе открытого исходного кода. Решайте сами, использовать наше облако или развернуть собственный микросервис.

Обратная связь

Любые вопросы, которые относятся к проекту, отправляйте на mail@pinc0de.com.