Текст в subject ID

GET /subjects

ListSubjects

Ищите людей, аккаунты и темы, включая ИИ, и получайте subject_id, которые принимают конечные точки субъектов. Активы не включены; для них используйте /assets или /search.

Правила параметров:

subject_id нельзя комбинировать с query.

Оплата кошельком доступна на https://nebula-api.hiddensystems.ai/api/v1/x402/subjects. Аккаунт Nebula или API-ключ не требуются; проверьте предложение об оплате перед подписанием. Руководство по оплате x402.

Параметры

subject_id string QUERY

Ищет один субъект по каноническому subject_id, который вернул /subjects или /search. Его нельзя комбинировать с query.

Example:text:jensen huang

query string QUERY

Поиск без учёта регистра по публичным идентификаторам и названиям.

Example:NVIDIA

limit integer QUERY

Максимальное число возвращаемых результатов.

Default:50

offset integer QUERY

Количество пропущенных результатов.

Default:0

Пример cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/subjects' \
  --header 'X-API-Key: YOUR_API_KEY'

Ответы

200 OK

400 Некорректный запрос

401 Не авторизован

402 Кредиты израсходованы; ответ содержит срок продления и баланс купленных кредитов

403 Доступ запрещён

404 Не найдено

405 Метод не поддерживается; поддерживаемые методы перечислены в заголовке Allow

429 Слишком много запросов

500 Внутренняя ошибка сервера

503 Сервис недоступен

Тип медиа application/json

has_more

boolean обязательный

True, когда после возвращённых записей доступна следующая страница.

limit

integer обязательный

Максимальное запрошенное количество записей.

offset

integer обязательный

Количество пропущенных подходящих записей.

subjects

array<object> обязательный

Субъекты, не являющиеся активами, соответствующие фильтрам обнаружения.

subjects[].name

string обязательный

Понятное человеку название.

subjects[].subject_id

string обязательный

Канонический идентификатор для не связанных с активами человека, аккаунта или темы.

{
  "has_more": false,
  "limit": 50,
  "offset": 0,
  "subjects": [
    {
      "name": "Artificial Intelligence",
      "subject_id": "text:artificial intelligence"
    }
  ]
}