Портал разработчика
Developer quickstart

Первое бизнес-действие через API

Создайте и прочитайте задачу через typed SDK с учётными данными operator sandbox.

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

Администратор создаёт product sandbox и OAuth app на 3 дня. Вход через браузер и внешние отправки отключены. В TASKA_SANDBOX_URL укажите выданный HTTPS-адрес.

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

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

OAuth 2.0
curl -X POST $TASKA_SANDBOX_URL/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. Получите поддержанный контракт

Версионированный набор содержит полные схемы запросов и ответов, а также требования идемпотентности. Общий каталог содержит отдельный legacy API.

Supported contracts
curl $TASKA_SANDBOX_URL/api/developers/supported-contracts \
  -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: process.env.TASKA_SANDBOX_URL!,
  oauth: {
    clientId: process.env.TASKA_CLIENT_ID!,
    clientSecret: process.env.TASKA_CLIENT_SECRET!,
    scope: ['developer:execute'],
  },
});

const created = await taska.createTask('developer-starter', {
  title: 'First partner task',
}, {idempotencyKey: 'quickstart-task-1'});
const task = await taska.readTask('developer-starter', {
  taskId: created.result.id,
});
console.log(task.result.title);