Skip to main content
Получайте полную информацию об одной конечной точке API по API ID — по сравнению с интерфейсом списка дополнительно включает поля definition (схема OpenAPI 3.0), service (сведения о принадлежащем сервисе) и products (связанные продукты). Подходит для таких сценариев, как автоматическая генерация SDK, передача описаний инструментов в LLM Agent, динамический рендеринг сайтов документации и других.
ℹ️ Этот интерфейс относится к API управления платформой AceDataCloud, единый префикс: https://platform.acedata.cloud/api/v1/. Полный индекс интерфейсов см. в разделе Получение списка документов платформы AceDataCloud.

Обзор интерфейса

В настоящее время доступны как /apis/{id}, так и /apis/{id}/; в примерах используется единый формат без завершающего слеша.

Описание аутентификации

Этот интерфейс полностью публичный, не требует токена учетной записи или состояния входа.

Параметры пути

Примеры запросов

cURL

Python

Node.js

Пример ответа (HTTP 200)

Описание полей ответа

Интерфейс сведений дополнительно включает, помимо полей интерфейса списка:

Обработка ошибок

Практические советы

  • Поле definition очень большое: схема OpenAPI одного API может содержать сотни строк JSON. Если нужен только индекс сервисов и Schema не требуется, следует использовать интерфейс списка вместо него.
  • Распространенный способ генерации SDK:
  • Отслеживание изменений API: поле updated_at — это время последнего изменения schema. Подписка на это поле позволяет автоматически повторно генерировать SDK при изменениях OpenAPI.

Связанные интерфейсы