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
- Cadastre a agência com sua própria razão social. → Como se cadastrar
- 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.
- 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
- 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.
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
- Entre no Portal de Anúncios como Administrador da organização ou Desenvolvedor.
- Escolha Modo de teste ou Modo real no seletor na parte superior da página.
- Acesse Chaves de API → Criar nova chave, dê um nome a ela e, se quiser, uma data de validade.
- 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.
