SDK de PHP para Astrología Prokerala
prokerala/astrology-sdk es el cliente oficial de PHP para la API de Astrología Prokerala v2. Proporciona una clase de servicio tipada por endpoint, abstracción HTTP PSR-18/17, caché de tokens opcional PSR-16 y objetos de resultado tipados con getters.
Repositorio fuente: https://github.com/prokerala/astrology-sdk
Cómo Usar Esta Habilidad
- Consumir el SDK (instalar, arrancar, primera llamada): lee
references/getting-started.md. - Encontrar la clase de servicio adecuada para un endpoint: lee
references/services.md(los 99 servicios mapeados a rutas de la API). - Modificar o extender el SDK (nuevos endpoints, clases de resultado, pruebas): lee
references/maintainer-guide.md. - Los parámetros de los endpoints, enumeraciones y esquemas de respuesta están documentados en la habilidad complementaria de la API
prokerala-astrology-api; esta habilidad del SDK no los duplica.
Requisitos
- PHP >= 8.0
- Paquetes de Composer:
prokerala/astrology-sdkmás una implementación PSR-17/PSR-18 (por ejemplo,nyholm/psr7+guzzlehttp/guzzle) y opcionalmente una caché PSR-16 (por ejemplo,symfony/cache) para el almacenamiento en caché de tokens.
Referencia 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: cualquier caché PSR-16; almacena en caché el token OAuth hasta su expiración.
$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();
- Los servicios toman el
Clienten su constructor y exponen un único métodoprocess(...). - Pasa las coordenadas mediante
Location; las fechas-hora comoDateTimeImmutable(el SDK las formatea internamente en ISO 8601). $client->getCreditUsed()devuelve los créditos de API consumidos por la última llamada (del encabezadoX-Api-Credits).
Excepciones
Todas en Prokerala\Common\Api\Exception, lanzadas por Client::process():
| Excepción | Estado HTTP | Significado |
|---|---|---|
ValidationException | 400 | Entrada no válida; contiene la lista completa de errors |
AuthenticationException | 401 | Credenciales incorrectas o caducadas |
QuotaExceededException | 403 | Créditos de API agotados |
RateLimitExceededException | 429 | Demasiadas solicitudes; esperar |
ServerException | 500 | Fallo del servidor |
Exception | otro | Clase base; captura general |
TokenExpiredException se maneja internamente (el cliente renueva el token y reintenta una vez); el código consumidor no necesita capturarla.