===== Содержание ===== * [[:ru:|Главная]] ==== Подписки с вводом номера ==== * [[:ru:subs0:|Сотовый оператор МТС]] * [[:ru:subs1:|Сотовый оператор Beeline]] * [[:ru:subs2:|Сотовый оператор Megafon]] ==== Псевдо подписки ==== * [[:ru:subs3:|Россия - все сотовые операторы]] * [[:ru:subs4:|Украина - все сотовые операторы]] ==== МО-подписки ==== * [[:ru:subs5:|Сотовый оператор МТС]] * [[:ru:subs6:|Сотовый оператор Beeline]] * [[:ru:subs7:|Сотовый оператор Megafon]] ==== Pay-By-Click ==== * [[:ru:subs8:|Pay-By-Click]] ==== Услуги SmsCoin ==== * [[:ru:service1:|смс:ключ]] * [[:ru:service2:|смс:банк]] * [[:ru:service6:|смс:транзит]] * [[:ru:service3:|смс:донейт]] * [[:ru:service4:|смс:контент]] * [[:ru:service5:|смс:чат]] ==== WAP-click ==== *[[:ru:subs9:|WAP-click, Билайн]]
Инструменты пользователя
Инструменты сайта
Боковая колонна
**Это старая версия документа.** ----
====== Описание интерфейса Pay-By-Click (PBC) HTTP API Версия 1.0 ====== ====== 1. Общие сведения ====== Услуга PBC - Pay By Click предназначена для тарификации абонентов с веб-сайта по клику абонента на кнопку "оплатить". Предварительно, каждый абонент должен быть "привязан" к сервису путем создания авторизационной записи.\\ \\ Тарификация не может пройти, если не создана авторизационная запись (исключения см. ниже). ====== 2. Терминология ====== **PBC** — общее название услуги. **Авторизационная запись** — запись, привязывающая данные абонента (его MSISDN) к проекту партнёра. Только при наличии авторизационной записи абонент может быть тарифицирован. Исключение - когда авторизация происходит на стороне партнёра (согласовывается индивидуально). **Проект** — сущность, созданная для партнёра, к которой идёт привязка всех авторизационных записей и тарификаций (транзакций). **Транзакция** — сущность, описывающая списание/зачисление денег с/на счёта партнёра в системе. **MSISDN** — номер телефона абонента, в международном формате, без "+" в начале. Например, "98765544321" ====== 3. Общие положения ====== Все запросы к API, за исключением описанных отдельно, выполняются с помощью GET- запроса. Все параметры должны быть экранированы согласно принятым стандартам.\\ \\ Ответ сервера всегда (за исключением ошибок) представляет собой данные в формате JSON.\\ \\ В случае ошибок, сервер возвращает соответствующий HTTP-код (например, 404 в случае не найденных данных или 400 В случае неправильных параметров запроса). Текст ответа может содержать ошибки (в текстовом формате).\\ \\ В каждом запросе должны присутствовать обязательные параметры:\\ ^ Параметры ^ Тип ^ Описание ^ | project | string(64) | идентификатор проекта, например, "p_proj". Выдаётся менеджером при подключении проекта. | | project_pass word | string(64) | пароль проекта, например, "pasw123". Выдаётся менеджером при подключении проекта. | | UUID | string(32) шестнадцатеричный, без дефисов | Уникальный индетификатор авторизационной записи абонента, созданной ранее. Пример: 9cf4a539dcb449708e51339c7dcda287 | ====== 4. Авторизация абонентов ====== Перед тарификацией абонентов, их необходимо авторизировать. \\ \\ Схема авторизации абонентов (см.рисунок в конце инструкции). **4.1 Создание авторизационной записи** При создании авторизационной записи, абоненту отправляется смс с паролем, который он должен ввести на следущем этапе активации (см. ниже).\\ \\ Для создания авторизационной записи нужно вызвать следущий URL: \\ \\[предоставляется в момент создания сервиса] \\ \\ с параметрами (метод GET): \\ ^ Параметры ^ Тип ^ Описание ^ | project | string(64) | идентификатор проекта, например, "p_someproject" | | project_pas sword | string(64) | пароль проекта, например, "phahfaeshaCh8joh" | | msisdn | string(16) | msisdn абонента, например "798764468986" | | ip | string(32) | IP-адрес абонента, с которого он инициировал создание авторизационной записи, например, "192.168.13.66" | ** 4.1.1 Ответ сервера, в случае успеха (формат JSON): ** {{{\\ { "auth_id": UUID }\\ }}} **4.2 Получение информации об авторизационной записи** Для получения информации об авторизационной записи (например, проверка периода действия), нужно вызвать URL:\\ \\ [предоставляется в момент создания сервиса]\\ с следующими параметрами:\\ \\ \\ ^ Параметры ^ Тип ^ Описание ^ | UUID | string(32) шестнадцатери чный, без дефисов | Уникальный индетификатор авторизационной записи абонента, созданной ранее. Пример: 9cf4a539dcb449708e51339c7dcda287 | ** 4.2.1 Ответ сервера, в случае успеха (формат JSON): ** {{{\\ { "active": true, "auth_id": "389eb6cd59774e869a79dd2b5ddc70e3", "create_date": "2012-09-09T17:35:30.705322", "expire_date": "2012-10-09T17:35:30.705322", "msisdn": "987654321" }\\ }}} Поля ответа: ^ Параметры ^ Тип ^ Описание ^ | command | text | Устанавливается параметр 'create' | | pseudo_sc | int | Короткий номер, определяющий стоимость подписки | | pseudo_text | text | Текст пригласительного сообщения | | pseudo_no_pin | int | Параметр должен быть равен единице. | | phone | varchar(16) | Номер абонента в международном формате без + или 00) |
Инструменты страницы
