---
title: "Прочитать записи собственного справочника приложения"
method: GET
path: "/api/v1/app/reference/{key}/items"
tags: ["App runtime"]
---

# Прочитать записи собственного справочника приложения

`GET /api/v1/app/reference/{key}/items`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/app/reference/{key}/items`
- Auth: HTTP bearer

Что сейчас лежит в справочнике, который завела установка этого приложения. Публичный слой `/api/v1/reference/{key}/items` отвечает на тот же вопрос человеку кабинета и отбирает справочники его правами; здесь предъявитель — сама установка, и видит она ровно своё.

ТОЛЬКО СВОЁ ПРОСТРАНСТВО. Ключ обязан лежать в `app.<издатель>.<ключ>.*` предъявителя. Чужой ключ отвечает 404 — тем же, чем несуществующий: сказать «сюда нельзя» значило бы подтвердить, что такой справочник у кабинета есть.

Ответ несёт то, чем приложение свои записи ведёт: код, подпись, порядок, вложенность, attrs и признак «жива». Кабинета в адресе нет — он берётся из токена установки.

## Path parameters

- `key` string, required

## Query parameters

- `q` string
- `limit` integer
- `offset` integer

## Headers

- `X-Tenant` string, required

## Response `200`

Записи справочника

- AppReferenceItemPage
  - `count` integer, required
  - `results` AppReferenceItem[], required
    - `id` string, uuid, required
    - `code` string, required: Ссылка на запись в смысле SDK: её присылает и по ней адресуется приложение
    - `label` string, required
    - `parent_id` string, uuid
    - `attrs` object: Дополнительные поля записи в том виде, в каком их прислало приложение
    - `sort_order` integer, required
    - `is_active` boolean, required: Погашенная запись остаётся разрешимой по ссылке и не предлагается в новых

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Справочника нет — в том числе если он принадлежит другому приложению

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)