You've already forked wc-licensed-product
Implement version 0.0.9 features
- Add API client examples for PHP, Python, JavaScript, curl, and C# - Create comprehensive REST API documentation in docs/client-examples/ - All examples include rate limit handling (HTTP 429) - Examples cover validate, status, and activate endpoints Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
188
docs/client-examples/php-client.php
Normal file
188
docs/client-examples/php-client.php
Normal file
@@ -0,0 +1,188 @@
|
||||
<?php
|
||||
/**
|
||||
* WC Licensed Product API Client for PHP
|
||||
*
|
||||
* A simple PHP client for interacting with the WC Licensed Product REST API.
|
||||
*
|
||||
* Requirements:
|
||||
* - PHP 7.4+
|
||||
* - cURL extension
|
||||
*
|
||||
* Usage:
|
||||
* $client = new WcLicensedProductClient('https://your-site.com');
|
||||
* $result = $client->validate('XXXX-XXXX-XXXX-XXXX', 'example.com');
|
||||
*/
|
||||
|
||||
class WcLicensedProductClient
|
||||
{
|
||||
private string $baseUrl;
|
||||
private int $timeout;
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @param string $siteUrl Your WordPress site URL (e.g., 'https://example.com')
|
||||
* @param int $timeout Request timeout in seconds
|
||||
*/
|
||||
public function __construct(string $siteUrl, int $timeout = 30)
|
||||
{
|
||||
$this->baseUrl = rtrim($siteUrl, '/') . '/wp-json/wc-licensed-product/v1';
|
||||
$this->timeout = $timeout;
|
||||
}
|
||||
|
||||
/**
|
||||
* Validate a license key for a specific domain
|
||||
*
|
||||
* @param string $licenseKey The license key to validate
|
||||
* @param string $domain The domain to validate against
|
||||
* @return array Response data
|
||||
* @throws Exception On request failure
|
||||
*/
|
||||
public function validate(string $licenseKey, string $domain): array
|
||||
{
|
||||
return $this->request('/validate', [
|
||||
'license_key' => $licenseKey,
|
||||
'domain' => $domain,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the status of a license
|
||||
*
|
||||
* @param string $licenseKey The license key to check
|
||||
* @return array Response data with status, domain, expiration, etc.
|
||||
* @throws Exception On request failure
|
||||
*/
|
||||
public function status(string $licenseKey): array
|
||||
{
|
||||
return $this->request('/status', [
|
||||
'license_key' => $licenseKey,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Activate a license on a domain
|
||||
*
|
||||
* @param string $licenseKey The license key to activate
|
||||
* @param string $domain The domain to activate on
|
||||
* @return array Response data
|
||||
* @throws Exception On request failure
|
||||
*/
|
||||
public function activate(string $licenseKey, string $domain): array
|
||||
{
|
||||
return $this->request('/activate', [
|
||||
'license_key' => $licenseKey,
|
||||
'domain' => $domain,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Make an API request
|
||||
*
|
||||
* @param string $endpoint API endpoint path
|
||||
* @param array $data Request data
|
||||
* @return array Decoded response data
|
||||
* @throws Exception On request failure
|
||||
*/
|
||||
private function request(string $endpoint, array $data): array
|
||||
{
|
||||
$url = $this->baseUrl . $endpoint;
|
||||
|
||||
$ch = curl_init();
|
||||
curl_setopt_array($ch, [
|
||||
CURLOPT_URL => $url,
|
||||
CURLOPT_POST => true,
|
||||
CURLOPT_POSTFIELDS => json_encode($data),
|
||||
CURLOPT_RETURNTRANSFER => true,
|
||||
CURLOPT_TIMEOUT => $this->timeout,
|
||||
CURLOPT_HTTPHEADER => [
|
||||
'Content-Type: application/json',
|
||||
'Accept: application/json',
|
||||
],
|
||||
]);
|
||||
|
||||
$response = curl_exec($ch);
|
||||
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
|
||||
$error = curl_error($ch);
|
||||
curl_close($ch);
|
||||
|
||||
if ($response === false) {
|
||||
throw new Exception('cURL error: ' . $error);
|
||||
}
|
||||
|
||||
$decoded = json_decode($response, true);
|
||||
|
||||
if (json_last_error() !== JSON_ERROR_NONE) {
|
||||
throw new Exception('Invalid JSON response: ' . json_last_error_msg());
|
||||
}
|
||||
|
||||
// Add HTTP code to response for easier handling
|
||||
$decoded['_http_code'] = $httpCode;
|
||||
|
||||
return $decoded;
|
||||
}
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Usage Examples
|
||||
// =============================================================================
|
||||
|
||||
// Uncomment to run examples:
|
||||
|
||||
/*
|
||||
$client = new WcLicensedProductClient('https://your-wordpress-site.com');
|
||||
|
||||
// Example 1: Validate a license
|
||||
try {
|
||||
$result = $client->validate('XXXX-XXXX-XXXX-XXXX', 'myapp.example.com');
|
||||
|
||||
if ($result['valid']) {
|
||||
echo "License is valid!\n";
|
||||
echo "Status: " . ($result['license']['status'] ?? 'active') . "\n";
|
||||
echo "Expires: " . ($result['license']['expires_at'] ?? 'Never') . "\n";
|
||||
} else {
|
||||
echo "License is not valid: " . ($result['message'] ?? 'Unknown error') . "\n";
|
||||
}
|
||||
} catch (Exception $e) {
|
||||
echo "Error: " . $e->getMessage() . "\n";
|
||||
}
|
||||
|
||||
// Example 2: Check license status
|
||||
try {
|
||||
$status = $client->status('XXXX-XXXX-XXXX-XXXX');
|
||||
|
||||
echo "License Status:\n";
|
||||
echo " Valid: " . ($status['valid'] ? 'Yes' : 'No') . "\n";
|
||||
echo " Status: " . ($status['status'] ?? 'unknown') . "\n";
|
||||
echo " Domain: " . ($status['domain'] ?? 'none') . "\n";
|
||||
echo " Expires: " . ($status['expires_at'] ?? 'Never') . "\n";
|
||||
echo " Activations: " . ($status['activations_count'] ?? 0) . "/" . ($status['max_activations'] ?? 1) . "\n";
|
||||
} catch (Exception $e) {
|
||||
echo "Error: " . $e->getMessage() . "\n";
|
||||
}
|
||||
|
||||
// Example 3: Activate license on a domain
|
||||
try {
|
||||
$result = $client->activate('XXXX-XXXX-XXXX-XXXX', 'newsite.example.com');
|
||||
|
||||
if ($result['success'] ?? false) {
|
||||
echo "License activated successfully!\n";
|
||||
} else {
|
||||
echo "Activation failed: " . ($result['message'] ?? 'Unknown error') . "\n";
|
||||
}
|
||||
} catch (Exception $e) {
|
||||
echo "Error: " . $e->getMessage() . "\n";
|
||||
}
|
||||
|
||||
// Example 4: Handling rate limits
|
||||
try {
|
||||
$result = $client->validate('XXXX-XXXX-XXXX-XXXX', 'example.com');
|
||||
|
||||
if (($result['_http_code'] ?? 200) === 429) {
|
||||
$retryAfter = $result['retry_after'] ?? 60;
|
||||
echo "Rate limited. Retry after {$retryAfter} seconds.\n";
|
||||
}
|
||||
} catch (Exception $e) {
|
||||
echo "Error: " . $e->getMessage() . "\n";
|
||||
}
|
||||
*/
|
||||
Reference in New Issue
Block a user