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-sdkmais 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
Clientno construtor e expõem um único métodoprocess(...). - Passe as coordenadas via
Location; passe datas-horas comoDateTimeImmutable(o SDK as formata como ISO 8601 internamente). $client->getCreditUsed()retorna os créditos de API consumidos pela última chamada (do cabeçalhoX-Api-Credits).
Exceções
Todas em Prokerala\Common\Api\Exception, lançadas por Client::process():
| Exceção | Status HTTP | Significado |
|---|---|---|
ValidationException | 400 | Entrada inválida; contém a lista completa de errors |
AuthenticationException | 401 | Credenciais inválidas ou expiradas |
QuotaExceededException | 403 | Créditos de API esgotados |
RateLimitExceededException | 429 | Muitas requisições; aguarde |
ServerException | 500 | Falha no servidor |
Exception | outros | Classe 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.