> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rockapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Руководство по маркетплейсу API: сравнение, подписка и тестирование

> Проверьте описание API, спецификацию OpenAPI, условия подписки, авторизацию, ответы и расход квоты до внедрения сервиса в приложение.

**Маркетплейс API** объединяет предложения сервисов, документацию и оформление доступа. Покупатель все равно должен проверить соответствие конкретного API своим требованиям. Наличие карточки или спецификации OpenAPI не гарантирует доступность, защиту данных или совместимость с приложением.

![Путь покупателя API от поиска и сравнения через подписку и тестирование к интеграции](https://mintcdn.com/rockapi/Y2PJHTzmky-wG67e/images/blog/api-marketplace-workflow.svg?fit=max\&auto=format\&n=Y2PJHTzmky-wG67e\&q=85\&s=8360bb64cd8c977178f5216bdd46bfd4)

На схеме сохранены английские подписи. Она показывает порядок покупки; инструменты тестирования и требования подписки зависят от сервиса.

## Отличайте модели от подписок на сервисы

Для модели ИИ начните с [актуального каталога и цен](https://rockapi.ai/pricing). Вызовы используют адреса моделей и применимые правила учета. Сторонний OpenAPI-сервис может требовать действующую подписку и иметь собственные адреса, авторизацию, квоты и условия продления. Не считайте Chat Completions общим методом для всех предложений и не переносите на них токенную тарификацию моделей.

| До подписки | Что сохранить |
| - | - |
| Функциональность | Нужные методы, входы, примеры ответов и ограничения |
| Авторизация | Источник ключа, формат заголовка, подписка и права |
| Расходы | Валюта, единица, включенный объем, превышение, продление и отмена |
| Эксплуатация | Ограничения частоты, тайм-ауты, ошибки и контакты поддержки |
| Данные | Условия хранения, обработки и разрешенного использования |

Если важной информации нет, спросите поддержку до оплаты. Цена без единицы и условий плана недостаточна для оценки месячного счета.

## Подготовьте небольшой тест по спецификации

Документ OpenAPI описывает HTTP-методы, пути, параметры, тела, схемы авторизации и ответы. Прочитайте требования нужной операции и сравните пример ответа с полями, на которые опирается приложение. При необходимости проверьте пагинацию, необязательные поля, пустые результаты и состояние асинхронных задач.

Используйте синтетические данные и запрос без нежелательных последствий. Если доступна операция только для чтения, начните с нее. Перед операцией изменения данных разберитесь в ее эффектах. Заранее определите небольшой бюджет и критерии успеха. Уточните наличие пробного доступа: тестирование не обязательно бесплатно.

## Используйте правильный путь доступа

Для сервиса маркетплейса изучите план, оформите подписку при необходимости и откройте онлайн-консоль, если она предусмотрена. Иначе используйте документированный пример сервиса. Создайте нужные учетные данные, проверьте полный URL и метод, отправьте минимальный допустимый запрос. Подробности есть в [руководстве по подписке и тестированию OpenAPI](https://docs.rockapi.ai/ru/blog/buyers/how-to-subscribe-and-test-openapi.md).

Для модели чата создайте ключ платформы на странице [ключей API](https://rockapi.ai/keys), сохраните в `ROCK_API_KEY`, а точный доступный вашей учетной записи ID — в `ROCK_API_MODEL`. Полный базовый URL SDK — `https://rockapi.ai/v1`; пример curl:

```bash theme={null}
curl --fail-with-body https://rockapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$ROCK_API_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Ответь: привет.\"}]}"
```

Задайте обе переменные и проверьте нужный баланс перед запуском. Покупатель не настраивает каналы поставщиков. Этот пример предназначен для модели чата, а не для любого API маркетплейса.

## Проверьте ответ и сопоставьте расход

Читайте статус и тело, а не только сообщение консоли об успехе. Проверьте документированный случай неверного ввода и обработку его ошибки в приложении. При `401` или `403` проверьте ключ, подписку и права, при `429` — квоту и лимиты. Сохраните время и ID запроса либо задачи без секретов.

Найдите окончательное списание или расход подписной квоты в журнале. [Руководство по оплате](https://docs.rockapi.ai/ru/pricing-and-billing.md) отделяет использование моделей от планов маркетплейса. Одна HTTP-ошибка не доказывает отсутствие начислений.

Перенесите подтвержденные метод, URL, заголовки и тело в код. Разделите тестовые и рабочие ключи, задайте тайм-ауты и предел повторов, затем используйте [контрольный список подписки](https://docs.rockapi.ai/ru/blog/buyers/api-subscription-checklist.md) перед ростом трафика.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.