> ## Documentation Index
> Fetch the complete documentation index at: https://platform.doodocs.kz/llms.txt
> Use this file to discover all available pages before exploring further.

# Обзор

> Developer API Doodocs People: программный доступ к сотрудникам, документам и событиям

Developer API — это REST-интерфейс Doodocs People для интеграций: синхронизации
сотрудников, ведения документов (создание, маршруты, подписание) и реакции на
изменения через вебхуки.

```
https://app.doodocs.kz/api/developer/v1
```

Все запросы аутентифицируются заголовком `X-API-Key`.

<Note>
  API в стадии preview: включается по запросу (флаг `developer_api`). Внутри `v1`
  только аддитивные изменения — новые поля, значения перечислений и ручки.
</Note>

## Ментальная модель

<Columns cols={2}>
  <Card title="Ключ = тенант + доступ" icon="key" href="/ru/api-reference/authentication">
    Ключ привязан к одному тенанту. Эффективный доступ — пересечение областей
    ключа и прав владельца; недоступные поля скрываются и перечисляются в
    `redacted_fields`.
  </Card>

  <Card title="Сущности" icon="users" href="/ru/guides/employees/model">
    Сотрудники (и employee-graph: отдел, должность, руководитель) и документы —
    полный цикл от шаблона до подписанного PDF.
  </Card>

  <Card title="События" icon="bell" href="/ru/api-reference/webhooks">
    Вебхуки `employee.*`, `person.changed` и `document.*` — реагируйте на
    изменения без опроса.
  </Card>

  <Card title="Пагинация и ошибки" icon="layer-group" href="/ru/api-reference/pagination">
    Списки — через `page_token`; ошибки несут строковый `code`; одиночный ресурс
    без доступа неотличим от несуществующего (`404`).
  </Card>
</Columns>

## Что доступно сейчас

* **Сотрудники** — список и карточка с `expand`, фильтрами и инкрементальной
  синхронизацией. → [Модель сотрудника](/ru/guides/employees/model)
* **Документы** — создание из шаблона или из загруженного PDF, маршруты,
  отправка, согласование, подписание (ЭЦП/КЭД) и скачивание. → [Документы: обзор](/ru/guides/documents/overview)
* **Вебхуки** — события по сотрудникам и документам. → [Вебхуки](/ru/api-reference/webhooks)
* **Ingest** — массовая загрузка оргструктуры (область `ingest:write`).

## С чего начать

<Columns cols={2}>
  <Card title="Быстрый старт" icon="rocket" href="/ru/quickstart">
    От ключа до первого ответа за пять минут.
  </Card>

  <Card title="Аутентификация" icon="key" href="/ru/api-reference/authentication">
    Ключи `X-API-Key`, области доступа и модель прав.
  </Card>

  <Card title="Сотрудники" icon="users" href="/ru/guides/employees/model">
    Модель сотрудника, employee-graph и синхронизация.
  </Card>

  <Card title="Документы" icon="file-lines" href="/ru/guides/documents/overview">
    Создать, направить по маршруту, подписать и скачать.
  </Card>
</Columns>