Перейти к основному содержимому

Подключение Webhook

  1. Перейдите в раздел «Подключить аккаунт» и выберите Webhook.

  2. Заполните данные

    Имя веб-узла — любое произвольное имя, используемое для удобного отображения аккаунта в списке.

    URL-адрес — адрес, на который будет отправляться запрос для подключения аккаунта и публикации Webhook.

    Секретный токен — необходим для аутентификации запросов клиента. В Headers запроса отправляется x-hub-signature, который необходимо проверить и сравнить на стороне клиента.

  3. Подтверждение домена При подключении аккаунта на ваш сервер поступит POST-запрос с JSON-данными. В ответ сервер должен вернуть строку 1qsRgoUgt.

    {
    "type": "confirmation",
    "project_id": "id-вашего-проекта"
    }
  4. Проверка секретного токена на стороне клиента

    <?php
    public const CLIENT_SECRET_KEY = '{Ключ, который указали в поле "Секретный токен" при подключении аккаунта}';

    /**
    * Проверка подписи запроса
    * @return bool
    */
    public function checkSignature()
    {
    $data = getPayload();
    $expectedSignature = hash_hmac('sha1', $data ? json_encode($data) : '', self::CLIENT_SECRET_KEY);
    $headerSignature = getRequestHeaders('x-hub-signature');
    $signature = strlen($headerSignature) === 45 && strpos($headerSignature , 'sha1=') === 0 ? substr($headerSignature, 5) : '';
    return hash_equals($signature, $expectedSignature);
    }

    /**
    * Получение данных запроса
    * @return array
    */
    private function getPayload()
    {
    $data = file_get_contents('php://input');
    return json_decode($data, true);
    }

    /**
    * Получение заголовка запроса
    * @param string $headerCode
    * @return string|null
    */
    private function getRequestHeaders($headerCode)
    {
    $requestHeaders = apache_request_headers();
    return isset($requestHeaders[$headerCode]) ? $requestHeaders[$headerCode] : null;
    }
    ?>
  5. Публикация поста При публикации поста на ваш сервер поступит POST-запрос с JSON-данными.

    {
    "action": "create_post",
    "project_id": int,
    "id": int,
    "type": "string",
    "title": "string",
    "content": "string",
    "location": {
    "id": int,
    "name": "string",
    "description": "string",
    "lat": float,
    "lng": float
    },
    "attaches": []
    }