# Agências, equipes e a API

Como agências anunciam clientes na Agilis com o nome de cada um, como funcionam funções da equipe, saldos e faturas, e como usar a API REST da Agilis.

**Em resumo:** a agência se cadastra uma vez, com sua própria razão social, e anuncia para seus clientes informando o nome de cada cliente em **Nome exibido aos membros**. A agência paga, mantém os saldos e recebe as faturas. Desenvolvedores podem criar e gerenciar ofertas e eventos pela **API REST da Agilis** (https://ads.agilis.dating) com chaves de API do Portal de Anúncios; o que é criado com chaves de teste é gratuito e nunca é exibido aos membros.

## Para agências

1. **Cadastre a agência** com sua própria razão social. → [Como se cadastrar](https://www.agilis.dating/pt-br/business/guide/register)
2. Ao criar uma oferta ou um evento, informe o **nome do seu cliente** em **Nome exibido aos membros**. Os membros veem o nome do cliente, não o seu.
3. Você precisa ter autorização de cada cliente para anunciar em nome dele. Os Termos de Publicidade atribuem essa responsabilidade à agência.

**Quem paga e quem recebe a fatura**

- A conta da sua agência paga, na moeda de cobrança da agência.
- Cada pessoa da sua agência tem o próprio saldo e paga com ele. O Saldo da organização é o total. → [Como funcionam os saldos](https://www.agilis.dating/pt-br/business/guide/pricing)
- As faturas e os resultados ficam em nome da sua agência, uma fatura por pagamento, para que você possa repassar a cobrança a cada cliente.
- Para manter separados os gastos de cada cliente, use uma oferta ou um evento por cliente e repasse a cobrança com base na respectiva fatura.

## Funções da equipe

Administradores da organização e Anunciantes trabalham no Portal de Anúncios; Desenvolvedores trabalham pela API. Desenvolvedores não podem criar ofertas ou eventos no Portal de Anúncios, mas, com suas chaves de API, podem criá-los, publicá-los e pagar por eles pela API, e sua empresa é responsável pelo uso das próprias chaves. A tabela completa está em [Funções e permissões da equipe](https://www.agilis.dating/pt-br/business/guide/getting-started).

## A API REST da Agilis

- **URL base:** https://ads.agilis.dating
- **Referência:** www.agilis.dating/api-doc, com exemplos em cURL, Python, Node.js e PHP, e um assistente de API
- **Leitura por máquina:** OpenAPI 3.1 em www.agilis.dating/openapi.json, Markdown em www.agilis.dating/api-doc.md e o texto completo para ferramentas de IA em www.agilis.dating/llms-full.txt
- **Ofertas:** listar suas categorias e os interesses; calcular o preço de uma oferta antes de criá-la; criar, listar, pausar, retomar e excluir ofertas; consultar os resultados de cada oferta
- **Eventos:** pré-visualizar, publicar, listar, editar, reagendar, cancelar e excluir eventos; consultar os resultados de cada evento

### Obtenha uma chave de API

1. Entre no Portal de Anúncios como Administrador da organização ou Desenvolvedor.
2. Escolha **Modo de teste** ou Modo real no seletor na parte superior da página.
3. Acesse **Chaves de API** → **Criar nova chave**, dê um nome a ela e, se quiser, uma data de validade.
4. **Copie a chave imediatamente.** Não será possível vê-la novamente.

As chaves de teste começam com `pk_test_`; as chaves reais começam com `pk_live_`. Cada pessoa pode ter até 10 chaves em cada modo. **Renovar chave** substitui a chave imediatamente, então atualize seus sistemas primeiro. Envie a chave no cabeçalho de solicitação `x-api-key`: `x-api-key: pk_test_…`.

### Desenvolva com segurança

- Desenvolva e teste com uma chave `pk_test_`: ofertas e eventos de teste são gratuitos e nunca são exibidos aos membros.
- Calcule o preço de uma oferta com o endpoint de estimativa de preço antes de criá-la.
- Mantenha as chaves fora de repositórios de código e de navegadores; chame a API a partir do seu servidor.

## Perguntas

### Uma agência pode gerenciar vários clientes com uma só conta?

Sim. Cadastre a agência uma vez e informe o nome do cliente em cada oferta ou evento.

### Cada cliente pode ter sua própria fatura?

As faturas são emitidas para sua agência, uma por pagamento. Repasse a cobrança aos seus clientes com base nelas.

### Existe um ambiente de testes (sandbox)?

Sim. O Modo de teste, com chaves `pk_test_`, é um ambiente de testes completo. Nada é cobrado e nada é exibido aos membros.

### Posso conectar ferramentas de programação com IA?

Sim. Aponte sua ferramenta para www.agilis.dating/api-doc.md ou www.agilis.dating/openapi.json.

Source: https://www.agilis.dating/pt-br/business/guide/agencies-and-api