CommunityRédaction et éditiongithub.com

prokerala/agent-skills

Compétences d'agent pour créer des intégrations avec l'API Astrologie Prokerala.

Qu'est-ce que agent-skills ?

Ce skill permet à un agent IA (tel que Claude Code, Cursor ou Codex) de construire des intégrations avec l'API Astrologie Prokerala v2 en utilisant le SDK PHP officiel `prokerala/astrology-sdk`. Il fournit des classes de service typées pour chaque endpoint, une abstraction HTTP PSR-18/17, un cache de jetons optionnel PSR-16, et des objets de résultat typés avec des accesseurs. Le skill inclut des références pour la prise en main, la sélection de services, et la maintenance du SDK. Il est utile pour les développeurs PHP souhaitant accéder à des données astrologiques (calculs de thèmes, nakshatras, etc.) de manière structurée et fiable, avec une gestion complète des erreurs via des exceptions spécifiques (validation, authentification, quota, limite de débit, erreur serveur). Le skill fonctionne avec PHP >= 8.0 et nécessite des packages Composer supplémentaires pour l'implémentation HTTP et le cache.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add prokerala/agent-skills

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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-sdk plus une implémentation PSR-17/PSR-18 (par exemple nyholm/psr7 + guzzlehttp/guzzle) et éventuellement un cache PSR-16 (par exemple symfony/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 Client dans leur constructeur et exposent une seule méthode process(...).
  • Passez les coordonnées via Location ; passez les date-heures sous forme de DateTimeImmutable (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ête X-Api-Credits).

Exceptions

Toutes dans Prokerala\Common\Api\Exception, levées par Client::process() :

ExceptionStatut HTTPSignification
ValidationException400Entrée invalide ; contient la liste complète des errors
AuthenticationException401Identifiants incorrects ou expirés
QuotaExceededException403Plus de crédits API
RateLimitExceededException429Trop de requêtes ; attends
ServerException500Erreur côté serveur
ExceptionautreClasse 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.

Skills associés