Skip to main content

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
  • 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
Last updated: October 12, 2026 at 12:38 PM UTC