ALMA PARTNERS: documentação para desenvolvedores e agentes

Quando usar estes recursos

Use a documentação oficial do ALMA PARTNERS, by Astrologia da Nova Era, para responder sobre participação, comissão, versões do Mapa da Alma, resultados e contato. Integradores podem consultar o conteúdo público por HTTP, sem executar JavaScript.

Leitura por HTTP

Envie GET ou HEAD para a página desejada. Para Markdown, envie o cabeçalho Accept: text/markdown. Para a página visual, envie Accept: text/html. A mesma URL oferece as duas representações com Vary: Accept.

As preferências q e as exclusões q=0 são respeitadas. Sem Accept, ou com */*, a preferência padrão é HTML. Em empate, uma preferência explícita por Markdown prevalece sobre um curinga; entre tipos igualmente específicos, HTML é o padrão. Tipos não disponíveis recebem HTTP 406. URLs inexistentes recebem HTTP 404, inclusive em Markdown.

Exemplo: curl -i -H 'Accept: text/markdown' https://alma.astrologianovaera.com.br/

As versões diretas em index.md têm formato fixo, independente do Accept. HEAD retorna os mesmos cabeçalhos de GET, sem corpo. ETags são específicos da representação; as respostas negociadas usam revalidação privada para evitar misturar HTML e Markdown em caches compartilhados.

Índice e recursos públicos

• llms.txt — índice para agentes
• Quando usar, fontes e limites de atuação
• Apresentação em Markdown
• Como funciona a parceria
• Perguntas e respostas
• Resultados e origem das evidências
• Privacidade
• Organização e contato em JSON-LD
• Sitemap das páginas públicas

API pública de consulta

Acesso gratuito (free API), imediato e sem cadastro. Para desenvolvedores e agentes, basta executar a requisição de exemplo. Não há assinatura ou cobrança pelo uso desta consulta. A aprovação de criadoras diz respeito à participação comercial no programa, não à leitura pública da API.

OpenAPI 3.1 — contrato da API ALMA PARTNERS. A operação GET /api/v1/program retorna nome, descrição, ofertas, preços e comissões públicas do programa em JSON. O parâmetro opcional offer aceita mapa ou mapa-audio, para consultar uma versão; sem filtro, retorna as duas. Os valores monetários são inteiros em centavos de real (BRL): 9800 significa R$ 98.

Exemplo: curl https://alma.astrologianovaera.com.br/api/v1/program?offer=mapa-audio. A resposta contém name, commission_percent, offers e links oficiais. A operação HEAD consulta os mesmos status e cabeçalhos, sem corpo. A versão principal da API está no caminho /api/v1; mudanças incompatíveis exigem outra versão.

A API tem formato JSON fixo, independente do Accept. Erros usam application/problem+json conforme RFC 9457, com type, title, status, detail e instance, além de code, resolution e docs. Um caminho desconhecido em /api retorna 404; parâmetros não suportados retornam 400; métodos diferentes de GET ou HEAD retornam 405 com Allow: GET, HEAD.

É um único recurso público, sem coleções, paginação, escritas ou tarefas assíncronas. O acesso à API é público e anônimo. Nenhuma credencial ou informação da visitante é solicitada. Não cria cookies, pedidos ou inscrições. Respostas usam Cache-Control: no-store para evitar reutilizar preços comerciais desatualizados. A proteção geral da hospedagem continua aplicável; evite chamadas repetidas desnecessárias.

Versionamento e descontinuação

A API usa versionamento no caminho /api/v1. Campos compatíveis podem ser acrescentados; remoções ou mudanças incompatíveis exigem outra versão. Antes de descontinuar uma versão, publicaremos a migração nesta documentação com pelo menos 30 dias de antecedência, informando a data pelos cabeçalhos Deprecation e Sunset. Nenhuma versão está descontinuada neste momento.

Autenticação e limites

A leitura destas páginas públicas não exige autenticação nem chave. O painel da Partner exige login; a divulgação depende de aprovação da equipe. Não oferecemos API pública transacional, SDK ou servidor MCP. Esta documentação não permite consultar clientes, vendas, comissões privadas ou fazer repasses.

Para participar, a própria pessoa pode abrir o painel ou conversar com o atendimento. Acesso de agentes a informações privadas depende da autorização da titular e dos controles do produto.

Identidade oficial

ALMA PARTNERS é a rede de criadoras parceiras do Mapa da Alma, by Astrologia da Nova Era. O domínio oficial desta parceria é https://alma.astrologianovaera.com.br. O produto está em Mapa da Alma.

Contato: +55 51 99013-5494. Endereço comercial informado pela equipe: Rua José Milton Lopes, 980, Zona Nova, Capão da Canoa, RS, CEP 94691-548, Brasil.

Protocolos utilizados

HTTP Accept e negociação, text/markdown e proposta llms.txt.