Аккаунт и использование

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"

Ответ

200 OK
{
  "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.idstringID рабочего пространства.
workspace.namestringНазвание рабочего пространства.
workspace.external_idstring | nullРежим партнёра: с заголовком Dcision-Workspace — external_id подпространства; иначе null.
workspace.parentobject | nullС заголовком Dcision-Workspace: { "id", "name" } вашего рабочего пространства, которое платит за подпространство. plan и usage тогда ваши.
workspace_usageobject | nullС заголовком Dcision-Workspace: { "used", "limit", "period_start", "period_end" } — оплачиваемые запуски подпространства в этом цикле и его лимит (null = без лимита).
api_key.idstringID ключа (key_…).
api_key.namestringИмя, данное ключу в разделе API-ключи.
api_key.prefixstringЗамаскированный ключ, как он показан в приложении, — никогда не полный секрет.
api_key.environmentstringlive или test.
plan.idstringgenesis, developer, growth или enterprise.
plan.namestringОтображаемое название тарифа.
plan.rate_limit_per_minuteintegerДопустимое число запросов в минуту для рабочего пространства — см. Rate limits.
plan.max_decisionsinteger или nullСколько решений может быть в рабочем пространстве; null — без ограничения.
plan.log_retention_daysintegerСколько тариф хранит выполнения.
plan.hard_capbooleantrue, если тариф не может продолжать работу за кредиты: после исчерпания включённого объёма вызовы блокируются с 402 QUOTA_EXCEEDED. false на Genesis, Developer и Growth — сверх включённого объёма они используют кредиты.
usage.usedintegerОплачиваемые решения в текущем периоде.
usage.includedintegerРешения, включённые в текущий период, — на годовых тарифах это объём на весь год.
usage.period_startstringНачало текущего расчётного периода, ISO 8601.
usage.period_endstringКонец текущего расчётного периода, 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`);

Ошибки

СтатусКодКогда
401INVALID_API_KEYКлюч отсутствует, имеет неверный формат, неизвестен или отозван.
429RATE_LIMITEDСлишком много запросов на чтение в текущую минуту.

Эндпоинты чтения — GET /v1/me и GET /v1/executions — используют собственное окно rate limit с поминутным лимитом вашего тарифа, поэтому их опрос никогда не замедляет ваши решения. Чтение не тарифицируется.

На этой странице