weijiajia/saloonphp-apple-client

A PHP client for Apple's APIs built with Saloon PHP HTTP client framework

dev-main 2025-03-13 07:48 UTC

Requires

• php: >=8.0
• saloonphp/saloon: ^3.0
• spatie/laravel-data: ^4.13
• weijiajia/saloonphp-cookie-plugin: @dev
• weijiajia/saloonphp-header-synchronize-plugin: @dev
• weijiajia/saloonphp-http-proxy-plugin: @dev
• weijiajia/saloonphp-logs-plugin: @dev

Requires (Dev)

• mockery/mockery: ^1.5
• phpunit/phpunit: ^9.0

MIT

• Wei Jiajia

• php
• api
• client
• apple
• icloud
• saloon
• apple-id

README

中文文档 | English

A PHP client for Apple's APIs built with Saloon.

Features

• Complete Apple API integration for various services:
  • Apple ID management
  • iCloud services
  • Account management
  • Authentication services
  • Buy/Purchase API
  • Report Problem services
• Built-in error handling for Apple-specific errors
• Cookie management for authenticated sessions
• HTTP proxy support
• Header synchronization
• Logging capabilities
• XML and Plist response parsing

Requirements

• PHP 8.0 or higher
• Saloon v3.0+

Installation

composer require weijiajia/saloonphp-apple-client

Usage

Basic Usage

// Create a connector instance
$connector = new AppleIdConnector();

// Configure proxy if needed
$connector->setProxy('http://proxy.example.com:8080');

// Make requests
$response = $connector->send(new SomeAppleRequest());

// Handle responses
$data = $response->getData();

Authentication

// Authenticate with Apple ID
$response = $connector->send(new LoginRequest([
    'apple_id' => '[e-mail]',
    'password' => 'your_password'
]));

// Handle 2FA if needed
if ($response->requiresSecurityCode()) {
    $securityResponse = $connector->send(new SecurityCodeRequest([
        'code' => '123456'
    ]));
}

Error Handling

The client includes specialized exception classes for various Apple API error scenarios:

try {
    $response = $connector->send($request);
} catch (UnauthorizedException $e) {
    // Handle authentication error
} catch (AccountLockoutException $e) {
    // Handle account lockout
} catch (VerificationCodeException $e) {
    // Handle verification code issues
} catch (AppleException $e) {
    // Handle general Apple API errors
}

Available Integrations

• AppleId
• Icloud
• Account
• Authentication
• Buy (Purchase API)
• ReportProblem
• WebIcloud
• Idmsa

License

This package is open-sourced software licensed under the MIT license.