SDK PHP Astrologie Prokerala
prokerala/astrology-sdk est le client PHP officiel pour l'API Astrologie Prokerala v2. Il fournit une classe de service typée par endpoint, une abstraction HTTP PSR-18/17, un cache de jetons PSR-16 optionnel, et des objets de résultat typés avec des accesseurs.
Dépôt source : https://github.com/prokerala/astrology-sdk
Comment utiliser ce skill
- Consommer le SDK (installation, amorçage, premier appel) : lire
references/getting-started.md. - Trouver la classe de service appropriée pour un endpoint : lire
references/services.md(tous les 99 services mappés aux chemins API). - Modifier ou étendre le SDK (nouveaux endpoints, classes de résultat, tests) : lire
references/maintainer-guide.md. - Les paramètres des endpoints, les énumérations et les schémas de réponse sont documentés dans le skill compagnon de l'API
prokerala-astrology-api; le skill du SDK ne les duplique pas.
Prérequis
- PHP >= 8.0
- Paquets Composer :
prokerala/astrology-sdkplus une implémentation PSR-17/PSR-18 (par exemplenyholm/psr7+guzzlehttp/guzzle) et éventuellement un cache PSR-16 (par exemplesymfony/cache) pour la mise en cache des jetons.
Référence rapide
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ème argument optionnel : tout cache PSR-16 ; met en cache le jeton OAuth jusqu'à son expiration.
$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();
- Les services prennent le
Clientdans leur constructeur et exposent une seule méthodeprocess(...). - Passez les coordonnées via
Location; passez les date-heures sous forme deDateTimeImmutable(le SDK les formate en ISO 8601 en interne). $client->getCreditUsed()retourne les crédits API consommés par le dernier appel (à partir de l'en-têteX-Api-Credits).
Exceptions
Toutes dans Prokerala\Common\Api\Exception, levées par Client::process() :
| Exception | Statut HTTP | Signification |
|---|---|---|
ValidationException | 400 | Entrée invalide ; contient la liste complète des errors |
AuthenticationException | 401 | Identifiants incorrects ou expirés |
QuotaExceededException | 403 | Plus de crédits API |
RateLimitExceededException | 429 | Trop de requêtes ; attends |
ServerException | 500 | Erreur côté serveur |
Exception | autre | Classe de base ; attrape-tout |
TokenExpiredException est gérée en interne (le client rafraîchit le jeton et réessaie une fois) ; le code consommateur n'a pas besoin de la capturer.