API доступ для команд, автоматизації та CI

Чому команди платять за API доступ

• Автоматизація генерації стилів без ручних дій у конструкторі.
• Стабільний експорт у CI з однаковим результатом у кожному релізі.
• Контроль використання через ключі, місячні ліміти та тарифікацію по запитах.

Типові сценарії

Швидкий старт

1. Увімкніть API Access у PRO/PREMIUM або купіть API add-on пакети.
2. Створіть ключ у профілі та збережіть його в змінних оточення.
3. Надсилайте авторизовані запити та відстежуйте використання в дашборді.

Перший запит за 5 хвилин

1. Увійдіть у акаунт і відкрийте блок Self-service API management на цій сторінці.
2. Створіть ключ (наприклад, Production CI) і одразу збережіть його в secret змінну.
3. Скопіюйте cURL приклад нижче, вставте свій X-API-Key і виконайте запит.
4. Із відповіді заберіть поле css і використовуйте його у файлі, шаблоні або CI-пайплайні.

Базові ендпоінти

Приклади запитів

cURL

curl -X POST "https://css-zone.com/api/api-access/generate/js-decompress" \
  -H "X-API-Key: cz_api_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceCode": "const a=n=>n.map(t=>t*2);export{a};",
    "options": {
      "renameIdentifiers": true,
      "retainComments": true,
      "outputLanguage": "js"
    }
  }'

JavaScript

const response = await fetch("https://css-zone.com/api/api-access/generate/js-execution-trace", {
  method: "POST",
  headers: {
    "X-API-Key": "cz_api_xxx",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    sourceCode: "function sum(a,b){return a+b}; function run(){return sum(2,3)}",
    options: { entryFunction: "run", entryArgs: [], timeoutMs: 5000 }
  })
});

const data = await response.json();

Приклад відповіді

{
  "code": "const get1 = input1 => input1.map(value1 => value1 * 2);\\nexport { get1 };",
  "stats": {
    "sourceBytes": 33,
    "outputBytes": 66,
    "sourceLines": 1,
    "outputLines": 2,
    "renamedCount": 2
  },
  "usage": {
    "periodMonth": "2026-02",
    "tier": "pro",
    "includedLimit": 5000,
    "includedUsed": 41,
    "includedRemaining": 4959,
    "billedUsed": 0,
    "totalRequests": 41,
    "creditsRemaining": 0
  }
}

Готовий приклад для GitHub Actions

Додайте API ключ у secrets (наприклад, CSS_ZONE_API_KEY), і pipeline буде генерувати CSS автоматично при пуші.

name: JS API Tools in CI
on:
  push:
    branches: [ main ]

jobs:
  js-decompress:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Decompress JS bundle chunk
        run: |
          curl -s -X POST "https://css-zone.com/api/api-access/generate/js-decompress" \
            -H "X-API-Key: $CSS_ZONE_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{"sourceCode":"const a=n=>n.map(t=>t*2);export{a};","options":{"renameIdentifiers":true,"outputLanguage":"js"}}' \
            > decompressed.json

      - name: Save JS artifact
        run: |
          cat decompressed.json | jq -r '.code' > output.js

Ліміти та тарифікація

• Стартовий API-пакет включає місячний ліміт запитів.
• Перевищення тарифікується за додаткові блоки запитів.
• У кожній відповіді повертаються заголовки з лімітами.

Типові API помилки

FAQ