---
title: "Версионирование CloudPrint API"
description: "Правила совместимости v1, допустимые дополнения, выпуск несовместимых версий, уведомления об устаревании и миграции."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/docs/">Документация CloudPrint</a><span aria-hidden="true">/</span><span>Справочник API</span></nav>

# Версионирование CloudPrint API

<p class="docs-lead">Правила совместимости v1, допустимые дополнения, выпуск несовместимых версий, уведомления об устаревании и миграции.</p>

<div class="api-reference-actions"><span><strong>Версия API:</strong> v1</span><a href="/docs/api/v1/openapi.json">Скачать OpenAPI v1 в формате JSON</a><a href="/docs/api/v1/explorer/">Открыть интерактивный справочник API</a><a href="/docs/api/v1/versioning/index.md">Открыть в Markdown</a></div>

## Основная версия в URL

Основная версия указана прямо в пути `/api/v1`, а соответствующая документация находится в `/docs/api/v1/`. Версии приложения вроде `0.7.1` не являются версиями API.

## Совместимые изменения v1

В `v1` могут добавляться методы, необязательные поля запроса, поля ответа, допустимые значения и промежуточные статусы. Клиент должен игнорировать неизвестные поля ответа и корректно обрабатывать новые неконечные статусы.

## Несовместимые изменения

Удаление или переименование операции или поля, добавление обязательного поля, изменение типа или требований авторизации требует новой основной версии и руководства по миграции.

## Устаревание версии

О предстоящем выводе версии сообщается в истории изменений API и руководстве по миграции. Когда применимо, ответы заранее получают стандартные заголовки `Deprecation` и `Sunset`.

## Связанная документация

<div class="docs-card-grid"><a class="docs-card" href="/docs/api/changelog/"><strong>История изменений CloudPrint API</strong><span>Изменения контракта и документации Public API отдельно от релизов продукта CloudPrint.</span></a>
<a class="docs-card" href="/docs/api/v1/"><strong>Справочник CloudPrint API v1</strong><span>Версионированная документация CloudPrint API по авторизации, принтерам, документам, заданиям, ошибкам и безопасным повторам.</span></a>
<a class="docs-card" href="/docs/api/v1/explorer/"><strong>Интерактивный CloudPrint API v1</strong><span>Интерактивный просмотр полного контракта OpenAPI CloudPrint API v1, схем и примеров.</span></a></div>

<nav class="docs-resource-links" aria-label="Следующие шаги"><a href="/docs/api/v1/explorer/">OpenAPI</a><a href="https://my.cloudprint.by">Открыть кабинет</a><a href="/docs/legal/privacy/">Политика конфиденциальности</a><a href="/docs/legal/terms/">Условия использования</a><a href="/docs/legal/payments-and-refunds/">Оплата и возврат</a><a href="/docs/legal/data-processing/">DPA</a></nav>