​
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

Your integration should gracefully handle new fields in API responses. Don’t use strict parsing that fails when encountering unknown fields.
Always check the HTTP status code and the success field in responses. Don’t assume requests succeeded.
Monitor your registered email for any API updates or announcements.