> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/instant-issuance/instant-issuance-es/integrar-la-api-de-d1/politica-de-cambios-de-la-api.md).

# Política de cambios de la API

Thales evolves the D1 API while keeping integrations stable.

Use this page to design your issuer backend to tolerate API changes.

### Backward compatibility rules

Design your issuer backend to tolerate API changes and extensions.

Your issuer backend must be resilient to these changes:

{% hint style="info" %}
Avoid **strict validation** in your issuer backend.

Strict validation rejects unknown fields.
{% endhint %}

* Thales may add optional parameters in HTTP headers, URLs, and JSON bodies.
* Error message strings may change between releases. Use them only for troubleshooting.
* Parameters sent or returned by D1 backend may evolve from optional to required.
* Parameters sent or returned by the issuer backend may evolve from required to optional.
* Parameter order is not fixed.
* New values may be added to existing enumeration parameters.
* New API operations may be added (new paths and/or HTTP methods).
* New HTTP response status codes may be added.

### Deprecations and end of life

Thales notifies the issuer at least **9 months** before end of life.

This applies to any API parameter or API operation.

After the deprecation period ends, do not use deprecated parameters or operations in:

* Production
* PreProd

Thales may shorten the deprecation period when required due to:

* A significant security risk
* A substantial economic or material technical impact
* Applicable law or payment network requirements

Deprecated parameters and operations are marked as deprecated in the technical documentation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/instant-issuance/instant-issuance-es/integrar-la-api-de-d1/politica-de-cambios-de-la-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
