# Webhooks

Вебхуки позволяют получать данные о событиях внутри Колизея сторонним сервисам или скриптам. 

На данный момент события всего два:

1. Информация о покупке товара.
2. Открытие уровня пользователем.

### Настройки

Переходим в раздел «Настройки»«Webhooks/API».

![](https://1542586809-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MUZ-mRId7_kqQCtuNOc%2F-MXpaXf0uakbI_iaylEk%2F-MXpkU9FA5UcsK7qHWtp%2F%D0%B0%D0%B0%D0%B0%D1%8B%D0%B2%D1%80%D1%80%D1%80%D1%80%D1%80%D1%80.PNG?alt=media\&token=148f07e7-6092-4e04-905f-81199757b1f4)

**URL сервера**\
Указываем адрес сервера, на который будет отправлен post-запрос с данными. Желательно добавить какой-то секрет в параметрах и после его проверять.\
\
**События**\
Включаем то, что хотим получать.

### Обработка

В ответ на каждое уведомление о событии ваш сервер должен отправить любой ответ с кодом 200. Если ответа нет или он имеет другой код, тогда после нескольких повторных попыток Колизей приостановит на время отправку запросов.

### Формат данных

Данные передаются в теле запроса в формате [JSON](https://ru.wikipedia.org/wiki/JSON). Пример кода на языке PHP для получения данных:

```
 $data = json_decode(file_get_contents('php://input'));
```

{% hint style="warning" %}
**Внимание!** Данные не будут доступны в массиве $\_POST.
{% endhint %}

**Покупка товара через Колизей**

```javascript
{ 
 type: "market_new_order", // тип события
 group_id: 1233, // id вашего сообщества 
 object: {    
  id: 1, // id заказа товара внутри Колизея
  owner_id: 1233, // id источника товаров, если не меняли, значит ваше сообщество
  pid: 234234, // id товара / если покупка через корзину, id первого товара 
  uid: 6764474666, // id пользователя
  price: 200, // сколько нужно доплатить в валюте, конечная цена в деньгах
  points: 5000, // сколько баллов было списано,
  products: [ // массив товаров из корзины
   {
    id: 12, // id товара
    count: 2, // количество
    name: "Ролл «Цезарь»", // название товара 
    type: "vk", // тип товара; vk - через метки, internal - внутренний товар
    tag: "@sale10", // название метки, если тип товара vk
   }
  ],
  questions: [ // массив вопросов
   {
    text: "Укажите адрес доставки", // текст вопроса
    answer: "СССР" // ответ пользователя
   }
  ],
  date: 1591691367 // дата-время в unixtime 
 }
}
```

**Открытие нового уровня**

```javascript
{
 type: "level_new_open", // тип события
 group_id: 1233, // id вашего сообщества
 object: {    
  uid: 746456458, // id пользователя
  level: 2, // уровень, который был открыт
  date: 1591691367 // дата-время в unixtime 
 }
}
```

### &#x20;  <br>