> ## 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.

# Синхронизация шаблонов

## I. Описание интерфейса

### 1. Пример запроса:

```hurl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST 'https://api.ycloud.com/v2/whatsapp/templates/{wabaId}/sync' \
-H 'X-API-Key: {{YOUR-API-KEY}}'
```

### 2. Тело запроса и параметры:

Параметры пути (Path parameters)

| Имя параметра | Тип | Обязательный | Примечание |
| - | - | - | - |
| wabaId | String | Да | WhatsApp Business Account ID |

Параметры заголовка (Header parameters)

| Имя параметра | Тип | Обязательный | Примечание |
| - | - | - | - |
| X-API-KEY | String | Да | API-ключ вашего аккаунта YCloud |

### 3. Сведения об ответе

Успешный ответ (200 OK)

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "wabaId": "string",
  "message": "string"
}
```

Информация о параметрах:

| Имя | Тип | Примечание |
| - | - | - |
| wabaId | String | WhatsApp Business Account ID |
| message | String | Описание статуса синхронизации |

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

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "wabaId": "123456789012345",
  "message": "Template sync has been triggered. It may take a few minutes to complete. If templates were recently migrated to this WABA on Meta, the system will automatically retry for up to 30 minutes."
}
```

## II: Спецификации интерфейса

### 1. Проверка авторизации

* Этот интерфейс предназначен только для партнеров по технической разработке.
* Он предназначен исключительно для аккаунтов WABA, уже привязанных к YCloud.

### 2. Ограничение частоты запросов

Этот интерфейс предусматривает двухуровневые ограничения по частоте запросов: на уровне WABA и на уровне тенанта. Если вас беспокоят эти ограничения, пожалуйста, свяжитесь с командой YCloud.

Ограничение на уровне WABA

* Временное окно: 10 минут
* Правило ограничения: каждый WABA может инициировать только один запрос на синхронизацию в течение временного окна.
* Сообщение об ошибке: "Template sync for this WABA was recently triggered. Please try again later."

Ограничение на уровне тенанта

* Временное окно: 1 час
* Максимальное количество запросов: 20 раз
* Правило ограничения: каждый арендатор (тенант) может инициировать до 20 запросов на синхронизацию в течение временного окна.
* Сообщение об ошибке: "Too many template sync requests from the tenant. Please try again later."

### 3. Автоматический повтор

Если платформа Meta возвращает пустой список шаблонов, система выполнит автоматический повтор:

* Максимальное количество повторов: 3 раза
* Интервал повтора: 5 минут → 10 минут → 15 минут
* Общая продолжительность попыток: 30 минут

### 4. Коды ошибок

| 403 | FORBIDDEN | Этот API доступен только для TP-партнеров. |
| - | - | - |
| 403 | FORBIDDEN | WABA не привязан к аккаунту YCloud |
| 429 | TOO\_MANY\_REQUESTS | Превышен лимит частоты запросов на уровне WABA |
| 429 | TOO\_MANY\_REQUESTS | Превышен лимит частоты запросов на уровне тенанта |


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