Prokerala Astrologie PHP SDK
prokerala/astrology-sdk ist der offizielle PHP-Client für die Prokerala Astrologie-API v2. Es bietet typisierte Service-Klassen pro Endpunkt, PSR-18/17 HTTP-Abstraktion, optionales PSR-16 Token-Caching sowie typisierte Ergebnisobjekte mit Gettern.
Quell-Repository: https://github.com/prokerala/astrology-sdk
So verwenden Sie dieses Skill
- SDK nutzen (Installation, Bootstrap, erster Aufruf): lesen Sie
references/getting-started.md. - Die richtige Service-Klasse für einen Endpunkt finden: lesen Sie
references/services.md(alle 99 Services, die API-Pfaden zugeordnet sind). - SDK ändern oder erweitern (neue Endpunkte, Ergebnisklassen, Tests): lesen Sie
references/maintainer-guide.md. - Endpunkt-Parameter, Enums und Antwortschemata sind im zugehörigen API-Skill
prokerala-astrology-apidokumentiert; das SDK-Skill dupliziert sie nicht.
Voraussetzungen
- PHP >= 8.0
- Composer-Pakete:
prokerala/astrology-sdksowie eine PSR-17/PSR-18-Implementierung (z. B.nyholm/psr7+guzzlehttp/guzzle) und optional ein PSR-16-Cache (z. B.symfony/cache) für Token-Caching.
Kurzreferenz
use GuzzleHttp\Client als 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();
// Optionales 6. Argument: ein beliebiger PSR-16-Cache; speichert das OAuth-Token bis zum Ablauf.
$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();
- Services nehmen den
Clientin ihrem Konstruktor entgegen und exponieren eine einzelneprocess(...)-Methode. - Koordinaten werden über
Locationübergeben; Datums- und Uhrzeitangaben alsDateTimeImmutable(das SDK formatiert sie intern als ISO 8601). $client->getCreditUsed()gibt die API-Credits zurück, die der letzte Aufruf verbraucht hat (aus demX-Api-Credits-Header).
Ausnahmen
Alle in Prokerala\Common\Api\Exception, geworfen von Client::process():
| Ausnahme | HTTP-Status | Bedeutung |
|---|---|---|
ValidationException | 400 | Ungültige Eingabe; enthält die vollständige errors-Liste |
AuthenticationException | 401 | Ungültige oder abgelaufene Anmeldeinformationen |
QuotaExceededException | 403 | Keine API-Credits mehr |
RateLimitExceededException | 429 | Zu viele Anfragen; abwarten |
ServerException | 500 | Serverfehler |
Exception | andere | Basisklasse; Auffangbecken |
TokenExpiredException wird intern behandelt (der Client erneuert das Token und wiederholt den Vorgang einmal); der aufrufende Code muss sie nicht abfangen.