​
Current Version

The Contazen API is currently at version v1, which is included in all API URLs: 
https://api.contazen.ro/v1/...

​
Version Header

Every API response includes the version in the metadata: 
{
  "success": true,
  "data": { ... },
  "meta": {
    "version": "v1",
    "response_time": "12.45ms"
  }
}

​
Stability

The v1 API is stable and production-ready. We are committed to maintaining backward compatibility for all v1 endpoints.

​
Backward Compatible Changes

We may add the following without changing the API version:

Additions

  • New endpoints
  • New optional parameters
  • New response fields
  • Additional functionality

Extensions

  • Additional error codes
  • Extended enum values
  • New status types
  • Enhanced features

​
Breaking Changes

If we need to make breaking changes in the future, we will:
  1. Release a new API version (v2)
  2. Maintain v1 alongside the new version
  3. Provide clear migration documentation
  4. Give advance notice to all API users
Examples of breaking changes include:
  • Removing endpoints or required parameters
  • Changing response structure
  • Modifying authentication methods
  • Altering core business logic

​
Best Practices