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.
Пов’язані інтерфейси
- Отримання списку API платформи AceDataCloud
- Отримання статистики викликів API платформи AceDataCloud
- Отримання деталей служби платформи AceDataCloud
- Отримання деталей документа платформи AceDataCloud — використовуйте
document_idдля переходу до документації розробника з рендерингом

