---
title: "Внешний доступ для агентов"
id: "2004"
type: "page"
slug: "external-api"
published_at: "2026-09-20T16:13:26+00:00"
modified_at: "2026-09-21T00:00:47+00:00"
url: "https://pastukhov.com/agents/ui/docs/external-api"
markdown_url: "https://pastukhov.com/agents/ui/docs/external-api.md"
excerpt: "Проблемы удобно смотреть глазами, но чинить их — работа программиста. Чтобы не пересказывать ему список…"
---

# Внешний доступ для агентов

[https://pastukhov.com/agents/ui/docs/external-api.md](https://pastukhov.com/agents/ui/docs/external-api.md)

Проблемы удобно смотреть глазами, но чинить их — работа программиста. Чтобы не пересказывать ему список вручную, у продукта есть отдельный вход для программ: по ключу доступа агент-программист забирает проблемы, читает доказательства, правит код и отмечает, что исправлено. Ниже — что доступно и как не выстрелить себе в ногу с ключом.

## Зачем это нужно

Агент интерфейсов находит проблемы, но не правит сайт — это работа того, кто пишет код. Замкнутый цикл получается, когда чинить тоже умеет программа: тогда проверка сама сообщает о поломке, исправление приходит, а следующий запуск подтверждает результат. Так работают связки с агентами-программистами, например с Pastukhov Agent.

## Что доступно по ключу

- **Список проблем** — с отбором по проекту и статусу.
- **Карточка проблемы** — всё то же, что видите вы: снимок, элемент, сообщение, история, число повторов. Снимок доступен и отдельной ссылкой.
- **Смена статуса** — закрыть или открыть заново.
- **Отчёт по экрану** — целиком вся история страницы: замечания, проверки, типы экранов. Удобно, когда разбираться надо не в отдельной ошибке, а в целой странице.

Пример запроса — просто чтобы показать, что это обычный текстовый вызов, а не какое-то особое устройство:

```
curl -H "X-API-Key: КЛЮЧ" https://ваш-сервер/api/ext/issues?project=shop&status=open
```

## Что будет без ключа

Если ключ не задан, эти адреса отвечают «не настроено» — то есть доступ просто выключен. Если ключ неверный — отказ. Вход по логину и паролю здесь не работает вообще: это разные способы доступа, и браузерная сессия для программ не годится. Так и задумано: внешний доступ существует для машин, и у него своя дверь.

## Рабочий цикл

1. Агент-программист забирает открытые проблемы проекта.
2. По каждой смотрит доказательства: сообщение, элемент, снимок — и понимает, что сломалось.
3. Правит код сайта и отмечает проблему закрытой.
4. Следующий запуск проверяет то же место и подтверждает, что проблема ушла.

Если правка не помогла, проблема откроется снова сама — тут продукт и замыкает круг, и не даёт обмануть себя отчётом «исправлено».

## Ключ — как пароль

Ключ доступа можно посмотреть и скопировать в разделе **Настройки → Тестирование UI** — он же используется дополнением Chrome. Относитесь к нему как к паролю: он даёт доступ к списку проблем и к снимкам страниц. Выдавайте его только тем, кто действительно должен видеть эти данные, и не выкладывайте в общедоступные места.

Дальше: как агент чинит сломавшиеся проверки сам — в разделе [Автоисправление](/agents/ui/docs/autofix)
.

[← Оглавление документации](/agents/ui/docs)