gRPC
Начните с Подключения через API, чтобы создать токен API платформы. Клиенты gRPC-Web используют https://reconstruct.dev. Нативный gRPC подключается к reconstruct.dev:443 по TLS и использует путь метода, сгенерированный из имени proto-сервиса. Каждый вызов требует метаданные authorization: Bearer <token>.
GetCaptureOptions возвращает поддерживаемые ID типов и окружения; клиентам не следует хранить фиксированный список. CatalogPlatform.view — тип платформы (desktop/mobile), а CatalogPlatform.implementation — окружение. Настольная платформа поддерживает web/web-extension/macos/windows/linux, мобильная — web/ios/android. captured указывает наличие сохранённых данных. MCP использует platform/environment для того же выбора; view страницы обозначает сохранённый профиль. См. каталог MCP.
Скачивание контракта
curl -fsSL https://reconstruct.dev/docs/proto/platform.proto -o platform.proto
Клиентский контракт содержит те же сервис, сообщения и номера полей, что и серверный. HTTP-аннотации опущены, поэтому генерация клиента не требует proto-файлов аннотаций API Google.
| RPC | Запрос | Результат |
|---|---|---|
ListCatalogs | page_size, необязательный page_token | catalogs[], необязательный next_page_token |
GetCaptureOptions | Пустой запрос | Поддерживаемые ID платформ/окружений, значения по умолчанию и варианты платформ для запросов; без аутентификации и учёта использования. |
GetCatalog | catalog_id, необязательный version | Метаданные, выбранный version, опубликованные versions[], screens[], варианты платформ/языков |
GetCatalogInsights | catalog_id, необязательные locale, view, implementation, section, version | version, technologies[], rendering, fonts[], text_styles[], assets[], color_themes[], page_count |
Передайте next_page_token как page_token следующего вызова для продолжения списка. ID каталогов получайте из ListCatalogs.
Контракт также включает GetCatalogFile (байты и тип содержимого, необязательный version), CreateRequest, ListRequests, GetRequest и операции учётной записи, оформления, аватара и персональных токенов из руководства REST. Для обоих видов API действуют одинаковые требования доступа. ListCatalogs поддерживает описанные там поиск, сортировку и повторяющиеся фильтры платформы.
WatchCatalogs передаёт поток changed и revision; укажите catalog_id для одного каталога или опустите его для списка и повторно используйте последнюю revision при переподключении. WatchRequests передаёт уведомления об изменениях запросов вызывающего пользователя. При changed: true обновляйте соответствующие данные. Потоки используют gRPC/gRPC-Web и не имеют HTTP-аннотации.
Генерация клиента
Пробный вызов через grpcurl
В каталоге с platform.proto, задав CR_RECONSTRUCT_API_TOKEN:
grpcurl \
-import-path . -proto platform.proto \
-H "authorization: Bearer ${CR_RECONSTRUCT_API_TOKEN}" \
-d '{"pageSize":10}' \
reconstruct.dev:443 \
reconstruct.platform.v1.PlatformService/ListCatalogs
Для нативной цели gRPC используйте имя хоста и порт без URL-пути.
Использование и оплата учётной записи
Управляйте подпиской и проверяйте использование в настройках учётной записи платформы. Персональные токены API и MCP дают доступ к операциям каталогов и запросов; управлять оплатой учётной записи ими нельзя.
Нормализованные данные интерфейса
Формат данных Scene определяет независимые от платформы артефакты интерфейса, включая состояния, ресурсы и свидетельства. Текущий нормализованный экспорт получается через MCP get_interface_scene; API каталогов не определяет отдельную операцию Scene.