PHP Example - User Signup

<?php
// User signup example (using production URL)
function signupUser() {
    $apiUrl = 'https://dev.us-east-1.spacedesigner3d.com/api2/signup';
    
    // Prepare data (store partnerId in environment variables or config)
    $postData = [
        'partnerId' => $_ENV['PARTNER_ID'], // Never hardcode this!
        'username' => 'newuser123',
        'email' => 'user@example.com',
        'password' => 'secure_password',
        'firstName' => 'John',
        'lastName' => 'Doe',
        'planId' => 1
    ];
    
    // Initialize cURL
    $curl = curl_init($apiUrl);
    curl_setopt_array($curl, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $postData,
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/x-www-form-urlencoded'
        ],
        CURLOPT_TIMEOUT => 30,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_SSL_VERIFYPEER => true
    ]);
    
    // Execute request
    $response = curl_exec($curl);
    $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
    $error = curl_error($curl);
    curl_close($curl);
    
    // Handle response
    if ($error) {
        throw new Exception("cURL Error: " . $error);
    }
    
    $data = json_decode($response, true);
    if ($httpCode !== 200 || $data['error']) {
        throw new Exception("API Error: " . ($data['error'] ?? 'Unknown error'));
    }
    
    return $data['data'];
}

// Project list example
function getProjectList($userKey) {
    $apiUrl = 'https://dev.us-east-1.spacedesigner3d.com/api2/projectList';
    
    $postData = [
        'partnerId' => $_ENV['PARTNER_ID'],
        'userKey' => $userKey
    ];
    
    $curl = curl_init($apiUrl);
    curl_setopt_array($curl, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $postData,
        CURLOPT_TIMEOUT => 30
    ]);
    
    $response = curl_exec($curl);
    $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
    curl_close($curl);
    
    $data = json_decode($response, true);
    
    if ($httpCode !== 200 || $data['error']) {
        throw new Exception("Failed to fetch projects: " . ($data['error'] ?? 'Unknown error'));
    }
    
    return $data['data'];
}

// Usage examples
try {
    $user = signupUser();
    echo "User created with ID: " . $user['id'] . "\n";
    
    $projects = getProjectList($user['key']);
    echo "Found " . count($projects) . " projects\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}
?>

cURL Examples

• Always check both HTTP status code AND the error field in the JSON response
• Implement retry logic for 429 (rate limit) and 503 (service unavailable) errors
• Validate input client-side to reduce 403 validation errors
• Handle file uploads gracefully with progress indicators and size checks
• Store and reuse userKey after successful authentication to avoid repeated logins
• Use HTTPS in production to protect sensitive data like partnerIds and userKeys