AstroApp

APIs de astrologia para websites e aplicações

Acrescente o poder do AstroApp ao seu website ou aplicação: APIs REST e plugins para WordPress e Joomla, para funcionalidades selecionadas do AstroApp.

Com as APIs do AstroApp, o seu website ou aplicação móvel pode pedir um cálculo astrológico ao AstroApp e mostrar o resultado como parte do seu próprio produto. Pode escolher entre três famílias de integrações de API: as APIs REST, os plugins para WordPress e Joomla, e as APIs JavaScript. Todas funcionam na mesma infraestrutura que o AstroApp, em vários centros de dados, e são capazes de suportar cargas contínuas de milhões de pedidos por dia. A marca branca e a personalização da marca também estão disponíveis.

APIs REST

Envia os dados do mapa numa chamada REST e recebe o cálculo que pediu. As APIs REST cobrem as seguintes funcionalidades do AstroApp:

  • Dados de mapas e imagens de mapas em vários estilos de mapa, ocidentais e védicos
  • Planetas, asteroides e planetoides, casas e aspetos, em coordenadas geocêntricas ou topocêntricas, com as posições eclípticas convertidas em ascensão reta e declinação a pedido
  • Retornos: solares, lunares e planetários, retornos às posições natais, a uma posição zodiacal dada ou a uma fase
  • Trânsitos a um mapa natal e trânsitos a trânsitos
  • Progressões secundárias e menores, filtradas por intervalo de datas, e progressões aos ângulos
  • Ingressos em signos, nakshatras, mansões lunares, termos e graus zodiacais
  • O estado da Lua: vazia de curso, mansão lunar, nakshatra, a fase atual e as seguintes
  • Dignidades essenciais e acidentais, 31 tipos ao todo
  • Estatísticas por signo e por casa
  • Dados de mapeamento de AstroCartography
  • Lugares e fusos horários: procure em mais de cinco milhões de lugares por cidade, hospital ou nome de lugar, ou por proximidade a coordenadas dadas. Cada localização inclui a história detalhada das suas mudanças de fuso horário

Pode autenticar-se com autenticação Basic ou com um token. Documentamos cada chamada numa coleção do Postman, com um exemplo prático em 30 linguagens de programação, incluindo cURL, PHP, Python, JavaScript, Node, Java e C: documentação da API REST do AstroApp. Também encontra no GitHub um SDK Java, gerado a partir das mesmas definições.

APIs JavaScript

Use as APIs JavaScript quando quiser um mapa na sua página web. O seu visitante introduz os dados de nascimento, e o mapa aparece num estilo ocidental ou védico, sem necessidade de nenhuma programação do seu lado no servidor. A mesma biblioteca dá-lhe também os dados por trás do mapa:

  • Planetas: longitude, latitude e velocidade dos planetas principais, dos asteroides, dos planetas hipotéticos, da Parte da Fortuna e das lunações pré-natais
  • Cúspides das casas
  • Aspetos, com a indicação de aplicação ou separação e o valor exato de cada um
  • Base de dados de cidades e base de dados de mudanças de fuso horário, com a possibilidade de procurar por nome e por proximidade de coordenadas

Algumas funções do lado do cliente não precisam de nenhum pedido: pontos médios, o aspeto entre dois objetos, posições em casas e signos, distâncias e utilitários de formatação. Pode restringir uma chave ao seu próprio endereço web, para que ninguém a possa copiar da sua página e usá-la noutro lado.

Chaves e utilização

Pode criar e gerir as suas chaves no portal de utilização das APIs, na sua conta AstroApp. Aí também pode acompanhar a utilização das suas APIs.

As APIs de JavaScript estão incluídas nas edições Pro e Financial Gold (apenas para uso pessoal). As APIs REST e os plugins para CMS (Joomla e WordPress) são um produto à parte, com os seus próprios planos de subscrição. Começa com uma quantidade diária gratuita e um método de pagamento registado, e a sua conta passa automaticamente para o preço por utilização quando ultrapassar pela primeira vez a sua quota diária gratuita. Para fazer o registo, visite a secção API da sua conta AstroApp, onde os planos e as regras de faturação são explicados em pormenor.

Perguntas frequentes

O que devolvem as APIs?

JSON para cada cálculo, e uma imagem quando pede um mapa. As APIs JavaScript também oferecem os mesmos dados como feeds XML, se os preferir.

Preciso de um servidor para usar as APIs JavaScript?

Não. O servidor é opcional para as APIs JavaScript, porque estas podem funcionar em qualquer página HTML estática. Quanto às APIs REST, usa-as a partir do seu próprio servidor ou aplicação, em qualquer linguagem de programação capaz de fazer um pedido HTTP.

Posso mostrar o mapa num estilo védico?

Sim. As imagens de mapas e as rodas JavaScript existem em estilos ocidentais e védicos, e os cálculos aceitam a ayanamsa e as vargas das configurações védicas.

Disponibilizam uma base de dados de lugares e localizações geográficas?

Sim. Pode procurar em mais de cinco milhões de localizações por nome e por proximidade a lugares geográficos indicados, e as procuras podem ser filtradas por países e estados. A história de todas as mudanças de fuso horário está incluída, para que um mapa de uma data passada use as regras de fuso horário em vigor nessa data.

Posso apresentar os resultados com a minha marca?

Sim. A marca branca e a personalização da marca estão disponíveis.

Ver também

Comparar edições e preços.