# Desenvolvedores e agentes | ALMA PARTNERS · Astrologia da Nova Era > Documentação oficial ALMA PARTNERS: leitura HTTP, Markdown, índice llms.txt, autenticação, contato e limites de integração com o Mapa da Alma. Fonte: [Desenvolvedores e agentes | ALMA PARTNERS · Astrologia da Nova Era](https://alma.astrologianovaera.com.br/developers/) Atualização: 2026-09-16. by Astrologia da Nova Era. [← ALMA PARTNERS](https://alma.astrologianovaera.com.br/) ## ALMA PARTNERS: documentação para desenvolvedores e agentes by Astrologia da Nova Era. Recursos públicos para consultar o conteúdo do Mapa da Alma e da parceria. ## 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](https://alma.astrologianovaera.com.br/llms.txt) - [Quando usar, fontes e limites de atuação](https://alma.astrologianovaera.com.br/agents.md) - [Apresentação em Markdown](https://alma.astrologianovaera.com.br/index.md) - [Como funciona a parceria](https://alma.astrologianovaera.com.br/como-funciona/index.md) - [Perguntas e respostas](https://alma.astrologianovaera.com.br/perguntas-frequentes/index.md) - [Resultados e origem das evidências](https://alma.astrologianovaera.com.br/resultados/index.md) - [Privacidade](https://alma.astrologianovaera.com.br/privacidade/index.md) - [Organização e contato em JSON-LD](https://alma.astrologianovaera.com.br/organization.jsonld) - [Sitemap das páginas públicas](https://alma.astrologianovaera.com.br/sitemap.xml) ## 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](https://alma.astrologianovaera.com.br/openapi.json) . 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](https://alma.astrologianovaera.com.br/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](https://mapadalma.astrologianovaera.com.br/) . 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](https://www.rfc-editor.org/rfc/rfc9110.html#section-12.5.1) , [text/markdown](https://www.rfc-editor.org/rfc/rfc7763) e [proposta llms.txt](https://llmstxt.org/) .