---
title: "Wersjonowanie CloudPrint API"
description: "Poznaj gwarancje zgodności v1, dozwolone rozszerzenia, zasady wydawania niezgodnych wersji, wycofywania i migracji."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/pl/docs/">Dokumentacja CloudPrint</a><span aria-hidden="true">/</span><span>Dokumentacja API</span></nav>

# Wersjonowanie CloudPrint API

<p class="docs-lead">Poznaj gwarancje zgodności v1, dozwolone rozszerzenia, zasady wydawania niezgodnych wersji, wycofywania i migracji.</p>

<div class="api-reference-actions"><span><strong>Wersja API:</strong> v1</span><a href="/docs/api/v1/openapi.json">Pobierz OpenAPI v1 w formacie JSON</a><a href="/pl/docs/api/v1/explorer/">Otwórz interaktywną dokumentację API</a><a href="/pl/docs/api/v1/versioning/index.md">Otwórz w Markdown</a></div>

## Wersja główna w adresie

CloudPrint zapisuje granicę zgodności w `/api/v1`, a dokumentacja używa `/docs/api/v1/`. Wersje aplikacji takie jak `0.7.1` nie są wersjami API.

## Zgodne zmiany v1

W `v1` mogą zostać dodane metody, opcjonalne pola żądań, pola odpowiedzi, dozwolone wartości i statusy pośrednie. Klient musi ignorować nieznane pola odpowiedzi i poprawnie obsługiwać nowe statusy niekońcowe.

## Zmiany niezgodne

Usunięcie lub zmiana nazwy operacji lub pola, dodanie pola wymaganego, zmiana typu albo wymagań autoryzacji wymaga nowej wersji głównej i przewodnika migracji.

## Wycofywanie wersji

Planowane wycofanie wersji jest ogłaszane w historii zmian API i przewodniku migracji. Gdy ma to zastosowanie, odpowiedzi wcześniej otrzymują standardowe nagłówki `Deprecation` i `Sunset`.

## Powiązana dokumentacja

<div class="docs-card-grid"><a class="docs-card" href="/pl/docs/api/changelog/"><strong>Historia zmian CloudPrint API</strong><span>Zmiany kontraktu i dokumentacji Public API niezależnie od wydań produktu CloudPrint.</span></a>
<a class="docs-card" href="/pl/docs/api/v1/"><strong>Dokumentacja CloudPrint API v1</strong><span>Wersjonowana dokumentacja CloudPrint API dotycząca uwierzytelniania, drukarek, dokumentów, zadań, błędów i bezpiecznych ponowień.</span></a>
<a class="docs-card" href="/pl/docs/api/v1/explorer/"><strong>Interaktywny CloudPrint API v1</strong><span>Interaktywny podgląd pełnego kontraktu OpenAPI CloudPrint API v1, schematów i przykładów.</span></a></div>

<nav class="docs-resource-links" aria-label="Następne kroki"><a href="/pl/docs/api/v1/explorer/">OpenAPI</a><a href="https://my.cloudprint.me">Otwórz panel</a><a href="/docs/legal/privacy/">Polityka prywatności</a><a href="/pl/docs/legal/terms/">Regulamin</a><a href="/pl/docs/legal/payments-and-refunds/">Płatności i zwroty</a><a href="/pl/docs/legal/data-processing/">DPA</a></nav>