Необходимые cookie-файлы нужны для работы сайта. Аналитические cookie (Яндекс Метрика) — только с вашего согласия. Политика cookie-файлов

Тема оформления
СправочникСправочник APIТипизаторы

Создать типизатор (версия 1)

Поддерживает Idempotency-Key. Доступ: ключ API со скоупом typizers:write или сессия.

Claude (откроется в новой вкладке)ChatGPT (откроется в новой вкладке)
POST/v1/typizersПесочница

Авторизация

Проверяем сессию Кабинета…

Тело запроса

application/json
Проверяем сессию Кабинета…

Authorization

headerAuthorizationBearer <token>

Ключ API (tz_live_…). Если операция требует скоупы, они нужны ключу; у сессии есть все скоупы.

Header Parameters

Typizer-Organization?string

Организация, от имени которой выполняется запрос (org_…). По умолчанию сессия действует от имени своей активной организации; ключ API может указать только свою.

Idempotency-Key?string

1–255 печатных символов ASCII, уникальных для каждой задуманной операции. Повтор с тем же ключом и тем же запросом в течение 24 часов возвращает первый результат (Idempotent-Replayed: true); тот же ключ с другим запросом или пока первый ещё выполняется — 409 idempotency_conflict.

Match^[\x20-\x7E]+$
Length1 <= length <= 255

Request Body

application/json
  1. body
name*string
Length1 <= length <= 120
description?|
Lengthlength <= 1000
schema*

Подмножество JSON Schema (draft 2020-12) с корнем object: не больше 200 полей и 10 уровней схемы (core), 131072 байт (128 КиБ) в компактном JSON в UTF-8, 64 уровней вложенности JSON (включая examples), и ни в одной строке нет NUL или непарного суррогата. Имена полей — буквы, десятичные цифры, _ и -, начинаются с буквы или _ (они становятся именами элементов XML). Порядок properties сохраняется: по нему идут столбцы результата, элементы XML и XSD.

instructions?string

Дополнительные указания для извлечения, передаются модели вместе со схемой

Lengthlength <= 4000
default_format?string

Формат выгрузки прогона, если формат не указан

Value in"json""xml""csv""xlsx"
mode?string

precise перепроверяет извлечение (оплачивается больше страниц)

Value in"standard""precise"

Response Body

Создан

application/json
  1. response
id*string
object*"typizer"
Value in"typizer"
name*string
description*string|null
version*integer

Текущая версия

schema*

Схема текущей версии

instructions*string
default_format*string

Формат выгрузки прогона, если формат не указан

Value in"json""xml""csv""xlsx"
mode*string

precise перепроверяет извлечение (оплачивается больше страниц)

Value in"standard""precise"
created_at*string
Formatdate-time
updated_at*string
Formatdate-time
curl -X POST 'https://api.typizer.ru/v1/typizers' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "schema": {}}'
Example Response
{  "id": "string",  "object": "typizer",  "name": "string",  "description": "string",  "version": 0,  "schema": {    "property1": null,    "property2": null  },  "instructions": "string",  "default_format": "json",  "mode": "standard",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}

Скачать исходное содержимое файла

Всегда скачивание (Content-Disposition: attachment), без отображения: содержимое — ровно то, что было загружено. Передача, сорвавшаяся на середине, обрывается, а не завершается раньше; сверяйте длину с Content-Length. HEAD отвечает теми же заголовками, не читая файл. Не больше 2 скачиваний одновременно на организацию (и на пользователя): сверх этого 429 с Retry-After. Доступ: ключ API со скоупом runs:read или сессия.

Архивировать типизатор

Типизатор пропадает из списка и с этого момента отвечает 404; его версии сохраняются для прогонов, которые их использовали. Доступ: ключ API со скоупом typizers:write или сессия.