CommunitySchreiben & Editierengithub.com

prokerala/agent-skills

Agent-Fähigkeiten zur Integration mit der Prokerala Astrologie-API.

Was ist agent-skills?

Dieses Skill bietet eine vollständige Integration der Prokerala Astrologie-API v2 über das offizielle PHP SDK `prokerala/astrology-sdk`. Es enthält typisierte Service-Klassen für jeden API-Endpunkt, PSR-18/17 HTTP-Abstraktion, optionales PSR-16 Token-Caching und Ergebnisobjekte mit Gettern. Entwickler können schnell alle 99 Astrologiedienste (z. B. Horoskop, Nakshatra, Geburtshoroskop) nutzen, indem sie den Client mit OAuth2 authentifizieren, Koordinaten und Datumsangaben übergeben und die entsprechende Service-Klasse aufrufen. Das Skill behandelt automatisch Token-Ablauf und bietet klare Ausnahmen für Validierungsfehler, Authentifizierungsprobleme, Kontingentüberschreitungen und Ratenbegrenzungen. Es ist für PHP ≥ 8.0 ausgelegt und erfordert einen PSR-17/PSR-18 HTTP-Adapter sowie optional einen PSR-16 Cache. Die Dokumentation verweist auf detaillierte Referenzen für den Einstieg, die Dienstzuordnung und die Erweiterung des SDKs, während die Parameter und Schemata der Endpunkte im separaten API-Skill `prokerala-astrology-api` gepflegt werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add prokerala/agent-skills

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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-api dokumentiert; das SDK-Skill dupliziert sie nicht.

Voraussetzungen

  • PHP >= 8.0
  • Composer-Pakete: prokerala/astrology-sdk sowie 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 Client in ihrem Konstruktor entgegen und exponieren eine einzelne process(...)-Methode.
  • Koordinaten werden über Location übergeben; Datums- und Uhrzeitangaben als DateTimeImmutable (das SDK formatiert sie intern als ISO 8601).
  • $client->getCreditUsed() gibt die API-Credits zurück, die der letzte Aufruf verbraucht hat (aus dem X-Api-Credits-Header).

Ausnahmen

Alle in Prokerala\Common\Api\Exception, geworfen von Client::process():

AusnahmeHTTP-StatusBedeutung
ValidationException400Ungültige Eingabe; enthält die vollständige errors-Liste
AuthenticationException401Ungültige oder abgelaufene Anmeldeinformationen
QuotaExceededException403Keine API-Credits mehr
RateLimitExceededException429Zu viele Anfragen; abwarten
ServerException500Serverfehler
ExceptionandereBasisklasse; Auffangbecken

TokenExpiredException wird intern behandelt (der Client erneuert das Token und wiederholt den Vorgang einmal); der aufrufende Code muss sie nicht abfangen.

Verwandte Skills