Prokerala 점성술 PHP SDK
prokerala/astrology-sdk는 Prokerala Astrology API v2의 공식 PHP 클라이언트입니다. 엔드포인트별 타입화된 서비스 클래스, PSR-18/17 HTTP 추상화, 선택적 PSR-16 토큰 캐싱, 게터가 있는 타입화된 결과 객체를 제공합니다.
소스 저장소: https://github.com/prokerala/astrology-sdk
이 스킬 사용 방법
- SDK 사용 (설치, 부트스트래핑, 첫 호출):
references/getting-started.md를 읽으십시오. - 엔드포인트에 적합한 서비스 클래스 찾기:
references/services.md를 읽으십시오 (99개 서비스 모두 API 경로에 매핑됨). - SDK 수정 또는 확장 (새 엔드포인트, 결과 클래스, 테스트):
references/maintainer-guide.md를 읽으십시오. - 엔드포인트 파라미터, 열거형, 응답 스키마는 동반 API 스킬
prokerala-astrology-api에 문서화되어 있습니다. SDK 스킬은 이를 중복하지 않습니다.
요구 사항
- PHP >= 8.0
- Composer 패키지:
prokerala/astrology-sdk및 PSR-17/PSR-18 구현체 (예:nyholm/psr7+guzzlehttp/guzzle), 선택적으로 토큰 캐싱을 위한 PSR-16 캐시 (예:symfony/cache).
빠른 참조
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번째 인수: 모든 PSR-16 캐시; 만료 시까지 OAuth 토큰을 캐싱합니다.
$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();
- 서비스는 생성자에서
Client를 받고 단일process(...)메서드를 노출합니다. - 좌표는
Location을 통해 전달하고, 날짜-시간은DateTimeImmutable로 전달합니다 (SDK는 내부적으로 ISO 8601 형식으로 변환). $client->getCreditUsed()는 마지막 호출에 사용된 API 크레딧을 반환합니다 (X-Api-Credits헤더에서 가져옴).
예외 처리
모두 Prokerala\Common\Api\Exception에 있으며, Client::process()에서 발생합니다.
| 예외 | HTTP 상태 | 의미 |
|---|---|---|
ValidationException | 400 | 잘못된 입력; 전체 errors 목록을 포함합니다 |
AuthenticationException | 401 | 잘못되었거나 만료된 자격 증명 |
QuotaExceededException | 403 | API 크레딧 소진 |
RateLimitExceededException | 429 | 너무 많은 요청; 잠시 멈춤 |
ServerException | 500 | 서버 측 오류 |
Exception | 기타 | 기본 클래스; 모든 예외 포착 |
TokenExpiredException은 내부적으로 처리됩니다 (클라이언트가 토큰을 갱신하고 한 번 재시도). 사용자 코드에서 이를 포착할 필요가 없습니다.