From b469510eeed87b642a9dbf9f7ab86aa577ccbb46 Mon Sep 17 00:00:00 2001 From: Ilya Sevostyanov Date: Wed, 3 Feb 2016 10:26:11 +0300 Subject: [PATCH] Fixed rest-versioning.md --- docs/guide-ru/rest-versioning.md | 12 ++---------- 1 file changed, 2 insertions(+), 10 deletions(-) diff --git a/docs/guide-ru/rest-versioning.md b/docs/guide-ru/rest-versioning.md index de81258a60..dd0462ce73 100644 --- a/docs/guide-ru/rest-versioning.md +++ b/docs/guide-ru/rest-versioning.md @@ -7,22 +7,14 @@ API используются клиентами, код которых вы не сохраняться. Если ломающее её изменение необходимо, делать его нужно в новой версии API. Существующие клиенты могут продолжать использовать старую, совместимую с ними версию API. Новые или обновлённые клиенты могут использовать новую версию. - + +> Tip: Чтобы узнать больше о выборе версий обратитесь к [Semantic Versioning](http://semver.org/). Общей практикой при реализации версионирования API является включение номера версии в URL-адрес вызова API-метода. Например, `http://example.com/v1/users` означает вызов API `/users` версии 1. Другой способ версионирования API, получивший недавно широкое распространение, состоит в добавлении номера версии в HTTP-заголовки запроса, обычно в заголовок `Accept`: -> Tip: Чтобы узнать больше о выборе версий обратитесь к [Semantic Versioning](http://semver.org/). - -Один из типичных способов реализации версионирования — указание версии в URL. Например, `http://example.com/v1/users` -соответствует `/users` версии 1. - -Ещё один способ, ставший сейчас популярным — передача версии через заголовок HTTP. Чаще всего для этого используется -заголовок `Accept`: - - ``` // как параметр Accept: application/json; version=v1