Портал разработчика
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);