Skip to main content
Отримайте повну інформацію про одну кінцеву точку API за ID API — на відміну від інтерфейсу списку, додаються поля definition (OpenAPI 3.0 Schema), 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 Schema одного API може містити сотні рядків JSON. Якщо потрібно лише створити індекс служб і Schema не потрібна, слід натомість використовувати інтерфейс списку.
  • Поширений спосіб використання для генерування SDK:
  • Відстеження змін API: поле updated_at — це час останньої зміни schema. Підписка на це поле дає змогу автоматично повторно генерувати SDK у разі змін OpenAPI.

Пов’язані інтерфейси