Documentation & API

<?php
// Complete workflow example
$apiKey = 'YOUR_API_KEY';
$baseUrl = 'https://api.getdocumentsigned.com/api/v1';

// Helper function for API requests
function makeApiRequest($method, $endpoint, $data = null) {
    global $apiKey, $baseUrl;
    
    $curl = curl_init($baseUrl . $endpoint);
    
    $headers = [
        'X-API-Key: ' . $apiKey,
        'Content-Type: application/json',
        'Accept: application/json'
    ];
    
    curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    
    if ($data && ($method === 'POST' || $method === 'PUT')) {
        curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($data));
    }
    
    $response = curl_exec($curl);
    $httpStatus = curl_getinfo($curl, CURLINFO_HTTP_CODE);
    
    if (curl_errno($curl)) {
        throw new Exception('API Request Error: ' . curl_error($curl));
    }
    
    curl_close($curl);
    
    $responseData = json_decode($response, true);
    
    if ($httpStatus >= 400) {
        throw new Exception('API Error: ' . 
            ($responseData['error']['message'] ?? 'Unknown error'));
    }
    
    return $responseData;
}

// Step 1: Upload document
function uploadDocument($fileBase64) {
    $data = [
        'name' => 'Employment Contract.pdf',
        'file' => $fileBase64
    ];
    
    return makeApiRequest('POST', '/documents', $data);
}

// Step 2: Add signature fields
function addSignatureFields($documentId) {
    $data = [
        'fields' => [
            [
                'type' => 'signature',
                'page' => 1,
                'x' => 100,
                'y' => 700,
                'width' => 200,
                'height' => 50,
                'required' => true,
                'signer_index' => 0,
                'label' => 'Employee Signature'
            ],
            [
                'type' => 'signature',
                'page' => 1,
                'x' => 400,
                'y' => 700,
                'width' => 200,
                'height' => 50,
                'required' => true,
                'signer_index' => 1,
                'label' => 'Employer Signature'
            ]
        ]
    ];
    
    return makeApiRequest('POST', "/documents/{$documentId}/fields", $data);
}

// Step 3: Send for signature
function sendForSignature($documentId) {
    $data = [
        'signers' => [
            [
                'email' => 'employee@example.com',
                'name' => 'John Employee',
                'message' => 'Please sign your employment contract'
            ],
            [
                'email' => 'employer@example.com',
                'name' => 'Mary Manager',
                'message' => 'Please review and sign'
            ]
        ],
        'expires_in' => 7,
        'reminder_interval' => 2 // Send reminder every 2 days
    ];
    
    return makeApiRequest('POST', "/documents/{$documentId}/send", $data);
}

// Full workflow execution
function executeWorkflow($fileBase64) {
    try {
        // Upload document
        $uploadResult = uploadDocument($fileBase64);
        if (!$uploadResult['success']) {
            throw new Exception($uploadResult['error']['message']);
        }
        
        $documentId = $uploadResult['data']['id'];
        
        // Add signature fields
        $fieldsResult = addSignatureFields($documentId);
        if (!$fieldsResult['success']) {
            throw new Exception($fieldsResult['error']['message']);
        }
        
        // Send for signature
        $sendResult = sendForSignature($documentId);
        if (!$sendResult['success']) {
            throw new Exception($sendResult['error']['message']);
        }
        
        return $sendResult['data'];
    } catch (Exception $e) {
        error_log('Error in document signing workflow: ' . $e->getMessage());
        throw $e;
    }
}

// Usage example (with file reading)
// $filePath = 'path/to/document.pdf';
// $fileContent = file_get_contents($filePath);
// $fileBase64 = base64_encode($fileContent);
// $result = executeWorkflow($fileBase64);
// print_r($result);
?>

import requests
import json
import base64

# Complete workflow example
api_key = 'YOUR_API_KEY'
base_url = 'https://api.getdocumentsigned.com/api/v1'

# Helper function for API requests
def make_api_request(method, endpoint, data=None):
    url = f"{base_url}{endpoint}"
    
    headers = {
        'X-API-Key': api_key,
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    }
    
    if method == 'GET':
        response = requests.get(url, headers=headers)
    elif method == 'POST':
        response = requests.post(url, headers=headers, json=data)
    elif method == 'PUT':
        response = requests.put(url, headers=headers, json=data)
    elif method == 'DELETE':
        response = requests.delete(url, headers=headers)
    else:
        raise ValueError(f"Unsupported HTTP method: {method}")
    
    response_data = response.json()
    
    if response.status_code >= 400:
        error_message = response_data.get('error', {}).get('message', 'Unknown error')
        raise Exception(f"API Error: {error_message}")
    
    return response_data

# Step 1: Upload document
def upload_document(file_base64):
    data = {
        'name': 'Employment Contract.pdf',
        'file': file_base64
    }
    
    return make_api_request('POST', '/documents', data)

# Step 2: Add signature fields
def add_signature_fields(document_id):
    data = {
        'fields': [
            {
                'type': 'signature',
                'page': 1,
                'x': 100,
                'y': 700,
                'width': 200,
                'height': 50,
                'required': True,
                'signer_index': 0,
                'label': 'Employee Signature'
            },
            {
                'type': 'signature',
                'page': 1,
                'x': 400,
                'y': 700,
                'width': 200,
                'height': 50,
                'required': True,
                'signer_index': 1,
                'label': 'Employer Signature'
            }
        ]
    }
    
    return make_api_request('POST', f'/documents/{document_id}/fields', data)

# Step 3: Send for signature
def send_for_signature(document_id):
    data = {
        'signers': [
            {
                'email': 'employee@example.com',
                'name': 'John Employee',
                'message': 'Please sign your employment contract'
            },
            {
                'email': 'employer@example.com',
                'name': 'Mary Manager',
                'message': 'Please review and sign'
            }
        ],
        'expires_in': 7,
        'reminder_interval': 2  # Send reminder every 2 days
    }
    
    return make_api_request('POST', f'/documents/{document_id}/send', data)

# Full workflow execution
def execute_workflow(file_base64):
    try:
        # Upload document
        upload_result = upload_document(file_base64)
        if not upload_result.get('success'):
            raise Exception(upload_result.get('error', {}).get('message', 'Upload failed'))
        
        document_id = upload_result['data']['id']
        
        # Add signature fields
        fields_result = add_signature_fields(document_id)
        if not fields_result.get('success'):
            raise Exception(fields_result.get('error', {}).get('message', 'Adding fields failed'))
        
        # Send for signature
        send_result = send_for_signature(document_id)
        if not send_result.get('success'):
            raise Exception(send_result.get('error', {}).get('message', 'Sending failed'))
        
        return send_result['data']
    except Exception as e:
        print(f"Error in document signing workflow: {str(e)}")
        raise

# Usage example (with file reading)
# def get_file_as_base64(file_path):
#     with open(file_path, 'rb') as file:
#         file_content = file.read()
#         return base64.b64encode(file_content).decode('utf-8')
#
# file_path = 'path/to/document.pdf'
# file_base64 = get_file_as_base64(file_path)
# result = execute_workflow(file_base64)
# print(json.dumps(result, indent=2))