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

# Ambientes e suporte

> Em quais ambientes usar a API, como acompanhar mudanças que afetam a sua integração e como pedir ajuda ao time do Symphony.

## O que é

Esta página explica em quais ambientes você pode usar a API, como ficar sabendo de mudanças que afetam a sua integração e como pedir ajuda ao time do Symphony.

## Ambientes

| Ambiente | Endereço | Para que serve |
| - | - | - |
| **Produção** | `https://symphony.fcamara.com` | Uso real. É o ambiente da sua empresa, com os seus modelos, agentes, bases e limite de consumo |
| **Homologação (HML)** | `https://symphony-hml.fcamara.com` | Ambiente de testes do time do Symphony. **O acesso é liberado sob pedido para colaboradores da FCamara** |

### Testando a sua integração

Não existe um ambiente de testes aberto (*sandbox*). Na maioria dos casos, você pode desenvolver direto em produção, com alguns cuidados:

* **Peça uma conta técnica dedicada** ao administrador da sua empresa. Assim o consumo dos testes fica separado do seu uso pessoal, e o administrador pode definir um limite de consumo baixo para essa conta.
* **Use modelos mais baratos** enquanto desenvolve e troque pelo modelo definitivo só no final.
* **Limite o volume.** Teste lotes com poucos itens antes de rodar o processamento completo.
* **Acompanhe o consumo** com `GET /api/v1/consumption/me`.

### Quando pedir acesso à homologação

Peça acesso ao HML quando você precisar:

* testar uma integração que pode gerar volume ou custo alto antes de liberar em produção;
* validar a sua integração contra uma versão do Symphony que ainda não chegou em produção.

<Warning>
  O HML tem uma **cópia de parte** do que existe em produção, mas não de tudo. Antes de testar, confira se a sua chave de API, o seu `X-Enterprise-Id` e os modelos e agentes que você vai usar existem no HML.
</Warning>

### Como solicitar acesso ao HML

O acesso ao HML é liberado **sob pedido** e apenas para **colaboradores da FCamara**. Para solicitar, entre em contato com o **time do Symphony** pelo [WhatsApp](https://wa.me/5511976183072) ou por e-mail [symphony@fcamara.com](mailto:symphony@fcamara.com).

## Mudanças na API

### Versão do Symphony

Para saber qual versão está rodando em um ambiente:

```bash theme={null}
curl https://symphony.fcamara.com/api/version
# { "version": "2.8.0" }
```

As novidades de cada versão são publicadas em [Releases](/changelog).

### O que é estável

A API não tem números de versão próprios. O `v1` que aparece em alguns caminhos (`/api/v1/...`) faz parte do endereço e não muda a cada versão do Symphony.

Para a sua integração continuar funcionando ao longo do tempo:

* **Use só os endpoints da [Referência da API](/desenvolvedores/api/referencia-da-api).** Endpoints fora dela são internos e podem mudar sem aviso.
* **Ignore campos que você não conhece** nas respostas. Campos novos podem ser adicionados a qualquer momento, e isso não é considerado uma mudança que quebra.
* **Trate erros pelo `code`**, nunca pelo texto da mensagem (veja [Erros e limites](/desenvolvedores/api/erros-e-limites)).
* **Não fixe IDs de modelo no código.** Leia o modelo de uma configuração e valide com `GET /api/models` na inicialização. O catálogo é gerenciado pela sua empresa e pode mudar.

## Suporte

### Antes de abrir um chamado

<Steps>
  <Step title="Confira o início rápido">
    Veja **Problemas mais comuns no começo** em [Conectar via API](/desenvolvedores/api/conectar-api). A maioria dos problemas iniciais é chave ou `X-Enterprise-Id`.
  </Step>

  <Step title="Procure o code do erro">
    Consulte o catálogo de códigos em [Erros e limites](/desenvolvedores/api/erros-e-limites).
  </Step>

  <Step title="Confirme permissões e limite">
    Confira com o administrador da sua empresa se a sua conta tem a permissão e o limite de consumo necessários.
  </Step>
</Steps>

### Quem procurar

| Assunto | Com quem falar |
| - | - |
| Chave de API, permissões, limite de consumo, ID da empresa, modelos e agentes disponíveis | **Administrador do Symphony na sua empresa** |
| Erro inesperado, comportamento diferente do documentado, pedido de novo endpoint, acesso ao HML | **Time do Symphony** |

Fale com o time do Symphony pelo [WhatsApp](https://wa.me/5511976183072) ou por e-mail [symphony@fcamara.com](mailto:symphony@fcamara.com).

### O que enviar no chamado

* O **`request_id`** da resposta de erro.
* O **ambiente** (produção ou HML).
* O **endpoint**, o **horário** aproximado e o fuso horário.
* O **status HTTP** e o **`code`** do erro.
* O corpo da requisição, **sem a chave de API**.

<Warning>
  **Nunca envie a sua chave de API**, nem em chamado, nem em e-mail, nem em print. Se ela vazar, gere uma nova na hora em **Configurações → Conta → Chaves de API**.
</Warning>

## Documentos relacionados

* [Conectar via API](/desenvolvedores/api/conectar-api)
* [Criando projetos com a API](/desenvolvedores/api/projetos-com-a-api)
* [Referência da API](/desenvolvedores/api/referencia-da-api)
* [Erros e limites](/desenvolvedores/api/erros-e-limites)


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