Как разработать приложение или интеграцию с CMS InSales | API для интеграции внешних сервисов

Уже более 7000 тысяч клиентов выбрали нашу платформу для ведения своего бизнеса, многим из них необходим специфичный функционал, который мы не планируем реализовывать. Мы создали мощный Интерфейс программирования приложений (API), который позволит решать задачи практически любого уровня сложности. Создавайте публичные приложения, и продавайте их через Центр Приложений прямо в бэкофисе для всех клиентов InSales.

ПОШАГОВАЯ ДОКУМЕНТАЦИЯ:

* https://goo.gl/TeuC8u - как интегрироваться
* https://goo.gl/Aq2wBf - для платежных решений
* https://goo.gl/KsuI8C - для способов доставки
* http://www.insales.ru/collection/documentation 
* github.com/insales - готовые обвертки

По техническим вопросам и API можно обращаться сюда - developers@insales.ru

ПРИМЕРЫ ХОРОШИХ ИНТЕГРАЦИЙ С ОТЛИЧНЫМ ПОНЯТНЫМ ОПИСАНИЕМ:

http://www.insales.ru/collection/apps/product/callbackkiller 
https://www.insales.ru/collection/sotsialnye-seti/product/cinhronizatsiya-s-tovarami-vkontakte 

После Вам потребуется добавить раздел на своем сайте с ссылкой на Инструкцию по настройке системы на InSales. Пример - http://payin-payout.net/applications/ 

Для тестирования своего приложения Вам необходимо пройти регистрацию в партнерской программе.
Регистрация в системе - https://www.insales.ru/partnership 
Далее необходимо протестировать готовое решение на тестовом магазине.
Приложения добавляются здесь - http://joxi.ru/Dr8KLJ9f4yBJQA 

ВАЖНО!

В рамках поддержки от SSL хотим попросить вас внести следующие изменения:

  1. Использовать только HTTPs-урлы для установки, удаления и входа в приложения.
  2. Виджеты в карточке заказа и товара должны уметь работать по HTTP и HTTPs на одних и тех же урлах, если из виджета делаются ajax-запросы, отправляются формы и т.п., то они тоже должны поддерживать HTTPs.
  3. Внешние js-скрипты и css-скрипты на сайте должны уметь подгружаться или всегда по HTTPs, или в зависимости от протокола на сайте выбирать HTTP или HTTPs автоматически. Если из скриптов делаются ajax-запросы, отправляются формы и т.п., то они тоже должны поддерживать HTTPs.
  4. Сертификаты не должны быть самоподписанные, необходимо следить за их экспарингом - чтобы основные браузеры, не считали их небезопасными.

ДЛЯ ПУБЛИКАЦИИ В APPS.INSALES.RU ВАМ НЕОБХОДИМО:

  • Актуальное лого 250х100 (если отличается от загруженного на сайт).
  • Актуальные скриншоты. Минимум 3 штуки: 1-й (скриншот сайта, с важной и интересной информацией), 2-й и 3-й (скриншоты интерфейсов, или вашего сервиса, или же процесса настройки интеграции).
  • Актуальное описание вашего сервиса до 3000 знаков. Описание какого-то оффера для клиентов InSales, если есть
  • Просьба проверить контактные данные или прислать их - для новых приложений.

Также необходимо сделать рассылку по своим клиентам и проанонсировать новость об интеграции с InSales.  

ПРАВИЛА INSALES ДЛЯ ПРИЕМКИ ПРИЛОЖЕНИЙ В APPSTORE

  1. Проверить карточку приложения: соответствие всем актуальным данным.
  2. Проверить описание приложения, наличие актуальной и рабочей инструкции. Просто ссылка на сайт вместо инструкции — это плохо.
  3. Установка приложения:
  • Уровень доступа приложения: должен соответствовать описанию. Лишние разрешения, равно как нехватка оных — это плохо.
  • Успешность установки приложения на разные вариации платформы (ru, kz, com.ua и остальные по мере их запуска).
  • Успешность установки при разных вариациях доменов (латиница, кириллица)
  • Автоматическое создание необходимых данных для работы приложения (способы доставки/оплаты, доп.поля и т. д.). Что именно должно создаваться вопрос к инструкции для приложения.
  1. Сохранение введенных данных, удобство и простота ввода (ко всем спорным полям нужны пояснения, необходимые для работы пункты не должны особо хорошо прятаться или же, если спрятать необходимо, в инструкции должно быть подробное разъяснение по поводу их нахождения.
  2. Наличие в приложении кнопки перехода в БО магазина.
  3. Работа приложения на сайте после настройки по инструкции.
  • Вывод необходимых полей и блоков, если они предполагаются, без нарушения верстки сайта.
  • Вывод и успешная работа доставок/оплат, если они предполагаются.
  • Соответствие работы описанию приложения.
  1. Передача данных от платформы к приложению/в другую систему и обратно, если это предполагается. Скорее всего, для проверки будут необходимы тестовые аккаунты.
  2. Наличие и корректная работа виджетов приложения, если такие предполагаются (как правило, на странице заказа в БО магазина).
  3. Выставление счетов, особенно если предполагается несколько тарифов для работы приложения.
  4. Удаление созданных приложением элементов: должна быть возможность их легкого восстановления без переустановки самого приложения.
  5. Вход в приложение, если оно уже установлено: приложение должно быть  доступно не только в первый раз до ввода настроек, но и при дальнейшей работе. При этом нежелательно каждый раз заставлять пользователя авторизироваться, лучше это делать автоматически.
  6. Удаление приложения — не должно нарушать работу сайта. При удалении приложения как минимум должны удалиться те элементы, к которым пользователь не имеет доступа, например, виджеты. Но не должны повредиться важные данные (созданные заказы, товары, структура категорий и т.д.)
  7. Переустановка приложения (удаление с установкой без ручного удаления скриптов, полей и т. д.) - в идеале, должны подхватываться старые данные. Обязательно должна не требоваться повторная регистрация, а использоваться уже имеющаяся учетная запись.

ОТ НАС:

  • Обновляемая документация;
  • Работающие заготовки под популярные языки программирования;
  • Обновляемые возможности API;
  • Консультация по возникающим вопросам;
  • Новые клиенты и интересные задачи (открываем доступ к Лид-центру InSales);
  • Анонсы по всем зарегистрированным клиентам.
Полезные видео