Каталог игр
Dealaro
Избранное
Продать
Чаты
Войти
Dealaro

Правила API

1. Статус правил

1.1. Настоящие правила регулируют доступ к API продавца Платформы Dealaro. Они дополняют Пользовательское соглашение, правила для продавцов и правила оплаты и возврата. При противоречии в части API применяются настоящие правила, если это не нарушает императивные нормы законодательства РФ.

1.2. Выпуск ключа, сохранение адреса вебхука, отправка запроса с ключом или приём вебхука означает, что Пользователь прочитал эти правила и принимает их. Техническое описание запросов не заменяет правила и размещено в документации.

1.3. Оператор — индивидуальный предприниматель Сотников В.А. API не делает Оператора стороной сделки между Пользователями и не меняет порядок выплат, удержаний, споров и верификации.

2. Для чего выдаётся ключ

2.1. Ключ подтверждает запросы самого Пользователя к API. Им можно только то, что прямо описано в документации действующей версии: отправить текстовое сообщение в свой чат, получить свои чаты и заказы, отметить свой оплаченный заказ выполненным, прочитать журнал доставки вебхука и принимать вебхук о новом сообщении или смене статуса своего заказа.

2.2. Ключ нельзя использовать для иных целей. В том числе нельзя собирать им данные, которые API не отдаёт, действовать от имени другого Пользователя, автоматизировать обход правил Платформы, рассылать сообщения не своим контрагентам по сделке, перепродавать доступ или встраивать ключ в сервис для третьих лиц.

2.3. API не отменяет блокировки, сроки, проверки, гарантийный период и правила споров. Запрос, который Платформа отклонила в кабинете, не становится допустимым из-за того, что он отправлен ключом.

3. Ключ: хранение у Оператора и обязанность Пользователя

3.1. Ключ показывается один раз, в момент выпуска или замены. Оператор хранит не сам ключ, а его необратимый хеш. Восстановить ключ из хеша нельзя. Повторно показать ключ Оператор не может и не обязан. Хеш не передаётся третьим лицам и не подставляется в запросы к чужим адресам.

3.2. С момента показа ключ является секретом Пользователя. Пользователь обязан хранить его так, чтобы его не увидели посторонние: не отправлять в чаты, почту, тикеты, скриншоты, репозитории, логи и сторонние сервисы, не передавать сотрудникам без необходимости и не вставлять в клиентский код, который виден посторонним. Передача ключа третьему лицу не перекладывает последствия на Оператора.

3.3. Все запросы с действующим ключом считаются запросами Пользователя, пока ключ не отозван. Это касается и случая, когда ключ потерян, оставлен в открытом виде, подсмотрен, утёк или найден другим лицом. Оператор не отвечает за сделки, сообщения, смену статуса заказа и иные действия, совершённые таким ключом.

3.4. Если ключ утрачен, есть сомнение, что его видел кто-то ещё, или Пользователь предполагает утечку, ключ нужно немедленно отозвать или заменить в панели управления. Отзыв и замена подтверждаются кодом: из приложения, если оно включено, иначе из письма. До отзыва риск несёт Пользователь. После замены прежний ключ не действует. Новый ключ тоже показывается один раз и хранится у Оператора только в виде хеша.

4. Секрет вебхука

4.1. Секрет вебхука задаёт Пользователь. Он нужен, чтобы на своём сервере отличить запрос Оператора: заголовок Authorization: Bearer и этот секрет. Оператор хранит секрет в базе в зашифрованном виде, потому что при доставке его нужно отправить на адрес, который указал Пользователь, и только на этот адрес.

4.2. Пользователь обязан хранить секрет не менее строго, чем ключ: не публиковать его и не передавать третьим лицам. Если секрет мог быть раскрыт, Пользователь обязан сразу задать новый. Оператор не отвечает за действия того, кто узнал секрет по вине Пользователя, и за решения, которые Пользователь принял, доверяя запросу без проверки секрета. Секрет — от 16 до 200 символов.

4.3. Адрес вебхука должен принадлежать Пользователю или быть законно предоставлен ему. Пользователь сам отвечает за доступность своего сервера, за сохранность того, что он принял, и за дальнейшую обработку этих сведений. Журнал доставки фиксирует статус попытки, код ответа и текст ошибки. Тело события в журнале не хранится.

4.4. Адрес можно сохранить до подтверждения. События на него не отправляются, пока на POST /api/automation/v1/webhook/confirm не придёт заголовок Authorization: Bearer с секретом этого адреса. Тело запроса не требуется. Другой адрес или другой секрет снова требуют такого запроса. До подтверждения Оператор события на адрес не шлёт.

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

5. Доступность и выплаты

5.1. Оператор не гарантирует бесперебойную и безошибочную работу API, вебхука, журнала и Платформы в целом. Стопроцентная доступность не обещается. Возможны паузы из-за обновления, сбоя оборудования, сети, базы данных, очереди сообщений, работ провайдера и иных причин, в том числе не зависящих от Оператора.

5.2. Недоставка вебхука, задержка, повтор, ошибка ответа Пользователя, отказ его сервера или временная недоступность API не означают, что сделка не состоялась, что выплата должна быть произведена немедленно, или что Оператор причинил убыток. Начисление, удержание и перечисление денег идут по правилам оплаты и возврата и по состоянию сделки на Платформе, а не по факту получения вебхука.

5.3. Оператор не отвечает за упущенную выгоду, потерю клиентов, простой автоматизации Пользователя, штрафы его контрагентов и иные косвенные последствия сбоя или недоступности API. Это ограничение действует в пределах, допустимых законодательством РФ, и не отменяет случаи, которые Соглашение прямо исключает из-под ограничения ответственности.

5.4. Пользователь строит свою автоматизацию так, чтобы сбой API не был для него единственным способом узнать статус заказа и не приводил к двойной выдаче, потере учёта или требованию к Оператору возместить то, что не было доставлено вебхуком.

6. Запрещённые действия

6.1. С ключом и без него запрещено пытаться нарушить работу Платформы или чужие данные. Под запретом, в частности:

  • уничтожение, порча, подмена или массовое удаление данных;
  • попытка остановить, перегрузить или вывести из строя сервис, базу, очередь или сеть;
  • удалённое выполнение кода, внедрение команд, обход авторизации и доступ к чужим аккаунтам, ключам и секретам;
  • поиск уязвимостей, сканирование, подбор и проверка обходных путей без предварительного письменного согласия Оператора;
  • использование ключа не для операций пункта 2.1, в том числе для исследования устройства Платформы.

6.2. Если такое действие выявлено, Оператор вправе навсегда заблокировать аккаунт, отозвать ключ, отключить вебхук и сохранить сведения, нужные для защиты прав и для обращения в уполномоченные органы. Блокировка API не отменяет уже возникшие обязанности по сделкам и расчётам.

6.3. Оператор также вправе без предварительного предупреждения ограничить частоту запросов, приостановить или отключить API, если ключ используется для рассылки, обхода правил, чрезмерной нагрузки или создаёт риск для других Пользователей либо для Платформы.

7. Срок и изменение

7.1. Доступ к API предоставляется без обязательства сохранять его бессрочно и в неизменном виде. Оператор может изменить набор операций, формат вебхука и эти правила. Новая редакция действует с момента публикации на этой странице, если в ней не указан более поздний срок.

7.2. Продолжение использования ключа после публикации новой редакции означает согласие с ней. Если Пользователь не согласен, он обязан отозвать ключ и прекратить запросы.