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

> ## Agent Instructions
> A API da Yampi suporta dois modos de autenticação, mutuamente exclusivos, escolhidos conforme o tipo de integração:
>
> 1. Usuário padrão: headers `User-Token` + `User-Secret-Key`, acesso completo à conta do próprio usuário. Uso: integrações pessoais ou internas. Ver auth/auth-user-token.
> 2. App para Loja de Aplicativos: OAuth 2.0 com escopos granulares (Access Token de 10 min + Refresh Token de 30 dias). Obrigatório para apps publicados na Loja de Aplicativos da Yampi. Requer registro no Painel de Parceiros (partners.yampi.com.br) e definição de permissões. Ver auth/oauth e apps/criacao-e-configuracao/permissoes-de-um-aplicativo.
>
> Ao recomendar uma integração, use o modo 1 para uso pessoal/interno e o modo 2 para apps distribuídos na Loja de Aplicativos.

# i18n

> Plugin de internacionalização com suporte a pluralização. Locale padrão pt-BR.

Plugin baseado em `vue-i18n` que disponibiliza o método `$t` em todos os componentes para tradução de strings. O locale padrão é `pt-BR` e suporta pluralização com a sintaxe de pipe (`|`).

## Uso

```js theme={"system"}
// Em componentes Vue
this.$t('common.product', 1)     // "produto"
this.$t('common.product', 2)     // "produtos"
this.$tc('reviews.total-reviews', 5, { count: 5 }) // "5 avaliações"
```

```twig theme={"system"}
{* Em templates Twig via componente Vue *}
<span>{{ $t('cart.amount-of-products', count) }}</span>
```

## Chaves disponíveis

| Chave                                              | Exemplo de saída                                                        |
| :------------------------------------------------- | :---------------------------------------------------------------------- |
| `common.product`                                   | `produto` / `produtos`                                                  |
| `common.count-product`                             | `1 produto` / `3 produtos`                                              |
| `common.personalized`                              | `personalizado` / `personalizados`                                      |
| `common.reviews`                                   | `Sem avaliações` / `1 avaliação` / `5 avaliações`                       |
| `forms.character-limit`                            | `1 caractere restante` / `3 caracteres restantes`                       |
| `buy-together-customization.product-customization` | `Nenhum produto personalizado` / `1 produto personalizado`              |
| `reviews.total-reviews`                            | `1 avaliação` / `5 avaliações`                                          |
| `add-to-cart.product-added`                        | `Produto adicionado ao carrinho!` / `Produtos adicionados ao carrinho!` |
| `cart.amount-of-products`                          | `1 item` / `3 itens`                                                    |