Аккаунт и использование
GET /v1/me — рабочее пространство, API-ключ и тариф, стоящие за ключом, плюс использование в текущем расчётном периоде. Проверяйте ключ в CI и следите за квотой из кода.
GET https://api.dcision.io/v1/meВозвращает, кому принадлежит API-ключ, — его рабочее пространство, сам ключ и тариф — и оплачиваемые решения, использованные в текущем расчётном периоде. Используйте его, чтобы проверить ключ в CI или при запуске и чтобы показывать квоту или оповещать о ней из собственного кода.
Запрос
Без параметров и без тела. Аутентификация теми же API-ключами, что и для решений:
curl https://api.dcision.io/v1/me \
-H "Authorization: Bearer $DCISION_API_KEY"Ответ
{
"workspace": { "id": "4c8f2a91-6d3b-4e7a-9f15-2b0c7d8e6a43", "name": "Acme", "external_id": null, "parent": null },
"workspace_usage": null,
"api_key": {
"id": "key_7Hq2Lm9Xc4Rv1Tz8Wn3B",
"name": "Production",
"prefix": "dcs_live_9fK2…0Ad2",
"environment": "live"
},
"plan": {
"id": "growth",
"name": "Growth",
"rate_limit_per_minute": 2000,
"max_decisions": null,
"log_retention_days": 30,
"hard_cap": false
},
"usage": {
"used": 1284311,
"included": 10000000,
"period_start": "2026-10-01T00:00:00.000Z",
"period_end": "2026-11-01T00:00:00.000Z"
}
}| Поле | Тип | Описание |
|---|---|---|
workspace.id | string | ID рабочего пространства. |
workspace.name | string | Название рабочего пространства. |
workspace.external_id | string | null | Режим партнёра: с заголовком Dcision-Workspace — external_id подпространства; иначе null. |
workspace.parent | object | null | С заголовком Dcision-Workspace: { "id", "name" } вашего рабочего пространства, которое платит за подпространство. plan и usage тогда ваши. |
workspace_usage | object | null | С заголовком Dcision-Workspace: { "used", "limit", "period_start", "period_end" } — оплачиваемые запуски подпространства в этом цикле и его лимит (null = без лимита). |
api_key.id | string | ID ключа (key_…). |
api_key.name | string | Имя, данное ключу в разделе API-ключи. |
api_key.prefix | string | Замаскированный ключ, как он показан в приложении, — никогда не полный секрет. |
api_key.environment | string | live или test. |
plan.id | string | genesis, developer, growth или enterprise. |
plan.name | string | Отображаемое название тарифа. |
plan.rate_limit_per_minute | integer | Допустимое число запросов в минуту для рабочего пространства — см. Rate limits. |
plan.max_decisions | integer или null | Сколько решений может быть в рабочем пространстве; null — без ограничения. |
plan.log_retention_days | integer | Сколько тариф хранит выполнения. |
plan.hard_cap | boolean | true, если тариф не может продолжать работу за кредиты: после исчерпания включённого объёма вызовы блокируются с 402 QUOTA_EXCEEDED. false на Genesis, Developer и Growth — сверх включённого объёма они используют кредиты. |
usage.used | integer | Оплачиваемые решения в текущем периоде. |
usage.included | integer | Решения, включённые в текущий период, — на годовых тарифах это объём на весь год. |
usage.period_start | string | Начало текущего расчётного периода, ISO 8601. |
usage.period_end | string | Конец текущего расчётного периода, ISO 8601. |
Расчётный период — это цикл подписки на платных тарифах и календарный месяц по UTC на Genesis; см. Тарифы, квоты и оплата.
Примеры
Пусть задание CI падает сразу, если ключ неверный:
dcision_me=$(curl -sf https://api.dcision.io/v1/me -H "Authorization: Bearer $DCISION_API_KEY") \
|| { echo "Invalid Dcision API key" >&2; exit 1; }
echo "$dcision_me" | jq -r '"\(.workspace.name) · \(.api_key.environment) · \(.plan.name)"'Предупреждайте до того, как включённый объём закончится, — сверх него решения расходуют кредиты:
const me = await fetch("https://api.dcision.io/v1/me", {
headers: { Authorization: `Bearer ${process.env.DCISION_API_KEY}` },
}).then((response) => response.json());
const share = me.usage.used / me.usage.included;
if (share >= 0.9) alert(`Dcision: ${Math.round(share * 100)}% of the included volume used`);Ошибки
| Статус | Код | Когда |
|---|---|---|
| 401 | INVALID_API_KEY | Ключ отсутствует, имеет неверный формат, неизвестен или отозван. |
| 429 | RATE_LIMITED | Слишком много запросов на чтение в текущую минуту. |
Эндпоинты чтения — GET /v1/me и GET /v1/executions — используют собственное окно rate limit с поминутным лимитом вашего тарифа, поэтому их опрос никогда не замедляет ваши решения. Чтение не тарифицируется.
Список и получение решений
GET /v1/decisions и GET /v1/decisions/{slug} — решения рабочего пространства API-ключа и контракт активной версии каждого — плюс делегирование решения в GPT-Live и его endpoint ответов.
Список выполнений
GET /v1/executions — последние запуски ваших решений с ответами, действием, причиной и метриками, с фильтрами по решению и статусу и пагинацией через курсор. Входные данные не возвращаются.