API v3 Environments

Overview

The Bookingkit API supports multiple environments for testing and production use. Each environment has its own set of URLs and configurations.

Available Environments

1. Production Environment

API URLs

• API Base URL: https://api.bookingkit.de
• API v3 Endpoint: https://api.bookingkit.de/v3
• OAuth Token Endpoint: https://api.bookingkit.de/oauth/token

Application URLs

• Admin Panel: https://admin.bookingkit.com

2. Sandbox Environment

API URLs

• API Base URL: https://api-sandbox.bookingkit.de
• API v3 Endpoint: https://api-sandbox.bookingkit.de/v3
• OAuth Token Endpoint: https://api-sandbox.bookingkit.de/oauth/token

Application URLs

• Admin Panel: https://admin-sandbox.bookingkit.com

Implementation Examples

PHP - Environment Detection

<?php
class BookingkitAPI {
    private $baseUrl;
    private $environment;
    
    public function __construct($environment = 'production') {
        $this->environment = $environment;
        $this->baseUrl = $this->getBaseUrl();
    }
    
    private function getBaseUrl() {
        switch ($this->environment) {
            case 'production':
                return 'https://api.bookingkit.de';
            case 'sandbox':
                return 'https://api-sandbox.bookingkit.de';
            default:
                throw new Exception('Invalid environment specified');
        }
    }
    
    public function getTokenUrl() {
        return $this->baseUrl . '/oauth/token';
    }
    
    public function getApiUrl($version = 'v3') {
        return $this->baseUrl . '/' . $version;
    }
}

JavaScript - Environment Configuration

class BookingkitAPI {
    constructor(environment = 'production') {
        this.environment = environment;
        this.baseUrl = this.getBaseUrl();
    }
    
    getBaseUrl() {
        const urls = {
            production: 'https://api.bookingkit.de',
            sandbox: 'https://api-sandbox.bookingkit.de'
        };
        
        if (!urls[this.environment]) {
            throw new Error('Invalid environment specified');
        }
        
        return urls[this.environment];
    }
    
    getTokenUrl() {
        return `${this.baseUrl}/oauth/token`;
    }
    
    getApiUrl(version = 'v3') {
        return `${this.baseUrl}/${version}`;
    }
}

Environment-Specific Features

Production Environment

• Full Feature Set: All features available
• Real Data: Live production data
• High Performance: Optimized for production load

Sandbox Environment

• Development Features: Latest development features
• Test Data: Isolated test data
• Debugging: Enhanced logging and debugging
• Experimental: New features in testing

Production Environment Warning

IMPORTANT: Testing is NOT ENCOURAGED on the production environment. Real costs will be associated with any operations performed in the production environment, even for testing purposes.

Production Environment Restrictions

• No Testing: Do not use production for development or testing
• Real Costs: All operations incur actual charges
• Live Data: All data is real and affects live business operations
• No Refunds: Costs incurred from testing cannot be refunded

Recommended Approach

• Always test in Sandbox first: Use the sandbox environment for all development and testing
• Production is for live use only: Only use production for actual business operations
• Verify in Sandbox: Ensure your integration works correctly in sandbox before production deployment

Best Practices

Environment Selection

1. Development: Use Sandbox for development and testing
2. Production: Use Production for live applications only

Environment Management

• Configuration: Use environment variables for configuration
• Secrets: Never hardcode credentials
• Testing: Test in lower environments before production
• Monitoring: Monitor all environments appropriately

Security Considerations

• Production: Highest security standards
• Sandbox: Isolated from production data

Migration Between Environments

Development Workflow

1. Local Development: Develop locally with mock data
2. Sandbox Testing: Test new features in sandbox
3. Production Release: Release to production

Support and Access

Environment Access

• Production: Requires production credentials
• Sandbox: Available for development partners

Remember to:

• Use the correct URLs for your target environment
• Configure authentication appropriately for each environment
• Test thoroughly in sandbox before production deployment
• Monitor your application's behavior across environments