Активировать пробный период Маркета

POST /v1/portals/:id/activate-market-trial

Включает одноразовый пробный период подписки BitrixGPT + Маркетплейс для аккаунта Битрикс24, к которому привязан вызывающий ключ. Результат тот же, что при оформлении пробного периода в кабинете, но без браузера. Возможность зависит от региона аккаунта: в регионе, где такой подписки нет, вызов пробный период не включает.

Параметры

Тело запроса не требуется, поэтому запрос отправляется без заголовка Content-Type. Клиент, который ставит Content-Type: application/json на любой запрос, обязан прислать тело {} — заголовок с пустым телом отклоняется до обработки вызова.

Примеры

curl — личный ключ

curl -X POST \
  -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.tech/v1/portals/YOUR_PORTAL_ID/activate-market-trial

curl — OAuth-приложение

curl -X POST \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  https://vibecode.bitrix24.tech/v1/portals/YOUR_PORTAL_ID/activate-market-trial

JavaScript — личный ключ

const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/portals/${portalId}/activate-market-trial`,
  {
    method: 'POST',
    headers: { 'X-Api-Key': 'YOUR_API_KEY' },
  },
)

const { success, data } = await res.json()
if (success) {
  // activated — включили сейчас, already_active — доступ был и до вызова
  console.log(data.status, data.trialEndsAt)
}

JavaScript — OAuth-приложение

const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/portals/${portalId}/activate-market-trial`,
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  },
)

const { success, data } = await res.json()

Поля ответа

Пример ответа

Пробный период включён этим вызовом:

{
  "success": true,
  "data": {
    "status": "activated",
    "trialEndsAt": "2026-08-01T00:00:00.000Z"
  }
}

Доступ у аккаунта уже был — поля trialEndsAt в ответе нет:

{
  "success": true,
  "data": {
    "status": "already_active"
  }
}

Пример ответа при ошибке

403 — идентификатор в пути принадлежит другому аккаунту:

{
  "success": false,
  "error": {
    "code": "PORTAL_MISMATCH",
    "message": "This key is not authorized for the requested portal"
  }
}

Ошибки

Полный список общих ошибок API — Ошибки.

Известные особенности

В ответе GET /v1/me идентификатора аккаунта нет. Там приходит только домен. Личный ключ берёт идентификатор из поля portalId записей GET /v1/apps — это работает, когда у аккаунта есть хотя бы одно приложение. Остальные источники — ответ GET /v1/portals по менеджмент-ключу либо кабинет. Без идентификатора вызов упирается в 403 PORTAL_MISMATCH.

Повторный вызов после успеха ничего не включает. Аккаунт, для которого пробный период уже активировали через Вайбкод, отвечает 409 ALREADY_ACTIVATED — платформа помнит факт активации и второй раз в Битрикс24 не обращается.

Ответ 200 не означает, что вызов что-то изменил. Аккаунт, у которого доступ уже есть, получает 200 со статусом already_active вместо отказа. Различать «включили сейчас» и «доступ был» нужно по полю data.status, а не по коду ответа.

Причину недоступности ответ не раскрывает. Код 409 TRIAL_ACTIVATION_UNAVAILABLE приходит на все условия одной формулировкой. Основные — аккаунт коробочный, аккаунт вне России и Беларуси, пробный период на стороне Битрикс24 уже израсходован, у аккаунта нет ключа разработчика. Перечень основными не ограничен: тем же кодом отвечает сбой на стороне платформы, который снимается только вмешательством поддержки. Поэтому отказ, противоречащий состоянию аккаунта, стоит переслать в поддержку, а не считать окончательным.

Лимит частоты считается на аккаунт и расходуется в том числе на отказах. Три запроса в час, и проверка идёт раньше остальных условий, поэтому неудачная попытка — с чужим идентификатором, с ключом только для чтения — уменьшает остаток так же, как удачная. Остаток и время сброса приходят в заголовках X-RateLimit-Remaining и X-RateLimit-Reset.

Смотрите также

• Менеджмент-ключи
• Список приложений
• Ключи и авторизация
• Режим доступа ключа
• Создать приложение
• Ошибки