Developer quickstart

Первый OAuth-запрос за несколько минут

Используйте sandbox credentials, получите capability contract и начинайте разработку.

1. Подключите Developer Access

Taska создаёт изолированный sandbox tenant и OAuth app. Client secret показывается один раз.

2. Обменяйте client credentials

Access token живёт 3600 секунд. Храните credentials в server-side secret manager.

OAuth 2.0

curl -X POST https://TENANT.taska.uz/api/oauth/token \
+  -H "Content-Type: application/x-www-form-urlencoded" \
+  -u "$TASKA_CLIENT_ID:$TASKA_CLIENT_SECRET" \
+  --data-urlencode "grant_type=client_credentials" \
+  --data-urlencode "scope=developer:execute"

3. Получите capability contract

Ответ содержит actions, JSON Schemas, scopes, permissions, risk, требования confirmation и idempotency.

Capabilities API

curl https://TENANT.taska.uz/api/developers/capabilities/service_ops \
+  -H "Authorization: Bearer $TASKA_ACCESS_TOKEN"

4. Подключите TypeScript SDK

SDK делает single-flight token refresh и даёт typed capability и execute methods.

TypeScript

import { TaskaClient } from '@taska/sdk';

const taska = new TaskaClient({
  baseUrl: 'https://TENANT.taska.uz',
  oauth: {
    clientId: process.env.TASKA_CLIENT_ID!,
    clientSecret: process.env.TASKA_CLIENT_SECRET!,
    scope: ['developer:execute'],
  },
});

const capability = await taska.capability('service_ops');