CommunityEscrita e Ediçãogithub.com

Prokerala Astrologia SDK PHP

Habilita a integração de agentes de IA com a API de Astrologia Prokerala, fornecendo classes de serviço tipadas para cada endpoint, abstração HTTP e cache de tokens.

O que é Prokerala Astrologia SDK PHP?

Esta skill permite que um agente de IA (como Claude Code, Cursor ou Codex) consuma de forma programática a API de Astrologia Prokerala v2 por meio do SDK PHP oficial (`prokerala/astrology-sdk`). Ela fornece uma classe de serviço tipada por endpoint (são 99 serviços), abstração HTTP baseada em PSR-18/17, cache opcional de tokens OAuth via PSR-16 e objetos de resultado tipados com getters. O agente pode usar a skill para obter dados astrológicos precisos (como mapas Kundli, posições planetárias, etc.) bastando informar as coordenadas e data/hora. A skill é útil para desenvolvedores que precisam de uma interface robusta e tipada para consultar a API, com tratamento de exceções padronizado e suporte a cache de autenticação. Ela é compatível com qualquer plataforma que suporte a execução de código PHP e integração com bibliotecas Composer. O funcionamento se baseia na instância de um cliente OAuth2, na criação de um objeto `Client` e na chamada do método `process()` de cada serviço, recebendo objetos `Location` e `DateTimeImmutable`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add prokerala/agent-skills

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Prokerala Astrologia SDK PHP faz?

prokerala/astrology-sdk é o cliente PHP oficial para a API de Astrologia Prokerala v2. Ele fornece uma classe de serviço tipada por endpoint, abstração HTTP PSR-18/17, cache opcional de tokens PSR-16 e objetos de resultado tipados com getters.

Repositório fonte: https://github.com/prokerala/astrology-sdk

Como Usar Esta Skill

  • Consumir o SDK (instalar, inicializar, primeira chamada): leia references/getting-started.md.
  • Encontrar a classe de serviço correta para um endpoint: leia references/services.md (todos os 99 serviços mapeados para os caminhos da API).
  • Modificar ou estender o SDK (novos endpoints, classes de resultado, testes): leia references/maintainer-guide.md.
  • Parâmetros de endpoint, enums e esquemas de resposta são documentados na skill complementar da API prokerala-astrology-api; esta skill do SDK não os duplica.

Requisitos

  • PHP >= 8.0
  • Pacotes Composer: prokerala/astrology-sdk mais uma implementação PSR-17/PSR-18 (ex.: nyholm/psr7 + guzzlehttp/guzzle) e, opcionalmente, um cache PSR-16 (ex.: symfony/cache) para cache de token.

Referência Rápida

use GuzzleHttp\Client as HttpClient;
use Nyholm\Psr7\Factory\Psr17Factory;
use Prokerala\Common\Api\Authentication\Oauth2;
use Prokerala\Common\Api\Client;
use Prokerala\Api\Astrology\Location;
use Prokerala\Api\Astrology\Service\Kundli;

$psr17Factory = new Psr17Factory();
$httpClient = new HttpClient();

// 6º argumento opcional: qualquer cache PSR-16; armazena em cache o token OAuth até expirar.
$authClient = new Oauth2($clientId, $clientSecret, $httpClient, $psr17Factory, $psr17Factory, $cache);
$client = new Client($authClient, $httpClient, $psr17Factory);

$location = new Location(23.1765, 75.7885, 0, new DateTimeZone('Asia/Kolkata'));
$datetime = new DateTimeImmutable('2022-03-17T10:50:40+05:30');

$result = (new Kundli($client))->process($location, $datetime);
$nakshatra = $result->getNakshatraDetails()->getNakshatra()->getName();
  • Os serviços recebem o Client no construtor e expõem um único método process(...).
  • Passe as coordenadas via Location; passe datas-horas como DateTimeImmutable (o SDK as formata como ISO 8601 internamente).
  • $client->getCreditUsed() retorna os créditos de API consumidos pela última chamada (do cabeçalho X-Api-Credits).

Exceções

Todas em Prokerala\Common\Api\Exception, lançadas por Client::process():

ExceçãoStatus HTTPSignificado
ValidationException400Entrada inválida; contém a lista completa de errors
AuthenticationException401Credenciais inválidas ou expiradas
QuotaExceededException403Créditos de API esgotados
RateLimitExceededException429Muitas requisições; aguarde
ServerException500Falha no servidor
ExceptionoutrosClasse base; captura genérica

TokenExpiredException é tratada internamente (o cliente renova o token e tenta novamente uma vez); o código do consumidor não precisa capturá-la.

Habilidades Relacionadas