> ## Documentation Index > Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt > Use this file to discover all available pages before exploring further. # YCloud API > Создавайте рабочие процессы для отправки сообщений, верификации, работы с контактами и событиями с помощью YCloud API. YCloud предоставляет единый API для клиентских коммуникаций и сценариев взаимодействия. Вы можете отправлять сообщения WhatsApp, SMS, email и голосовые сообщения. Также вы можете верифицировать пользователей, управлять контактами, отслеживать пользовательские события и получать обновления статусов через вебхуки. ## Как работают запросы Все серверные запросы используют следующий базовый URL: ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} https://api.ycloud.com/v2 ``` Аутентифицируйте запросы с помощью API-ключа в заголовке `X-API-Key`. Храните ключ на сервере и никогда не передавайте его в коде браузера или мобильного приложения. ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} curl https://api.ycloud.com/v2/balance \ --header "X-API-Key: $YCLOUD_API_KEY" \ --header "Accept: application/json" ``` Настройте API-ключ и выполните первый аутентифицированный запрос. Безопасно сохраняйте и используйте ваш API-ключ YCloud. Получайте обновления статусов сообщений и входящие сообщения. Изучите практические руководства по распространенным сценариям интеграции. ## Что можно создать Отправляйте шаблоны, текст, медиафайлы, интерактивные сообщения и многое другое. Отправляйте SMS по всему миру и автоматизированные голосовые коды. Отправляйте HTML- или текстовые письма с активированного домена. Управляйте WABA, номерами телефонов, шаблонами, Flows, медиафайлами и звонками. Управляйте контактами, пользовательскими событиями и отписками по каналам. ## Запрос Отправляйте тело запроса в формате JSON с `Content-Type: application/json`. Параметры пути и строки запроса описаны на странице каждого эндпоинта. ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} curl --request POST https://api.ycloud.com/v2/sms \ --header "X-API-Key: $YCLOUD_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "to": "+16315551234", "text": "Your order has shipped." }' ``` Используйте Справочник API, если вам нужна полная схема запроса, значения перечислений (enum) или интерактивный конструктор запросов. ## Ответ Успешные ответы возвращаются в формате JSON. Ответ на создание или отправку подтверждает, что YCloud принял запрос. Это не всегда означает окончательную доставку или выполнение. Сохраняйте возвращенный идентификатор ресурса и сопоставляйте его с результатами запросов или событиями вебхуков. Ошибки содержат машиночитаемый `code`, понятный разработчику `message` и `requestId`, который вы можете передать в службу поддержки YCloud. Для некоторых продуктов перед отправкой сообщений требуется активация аккаунта, подтвержденный отправитель или подключенный WhatsApp Business Account. ## От руководства к справочнику API Узнайте о диалоговых окнах сообщений, режимах отправки, полях запроса и статусах доставки. Изучите полную схему запроса и ответа для прямой отправки. Узнайте, как работают SMS-запросы и обновления статусов доставки. Изучите полную схему запроса и ответа для SMS. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.