Skip to content

Commit

Permalink
Fixed rest-versioning.md
Browse files Browse the repository at this point in the history
  • Loading branch information
i-sevostyanov committed Feb 3, 2016
1 parent 6d28678 commit b469510
Showing 1 changed file with 2 additions and 10 deletions.
12 changes: 2 additions & 10 deletions docs/guide-ru/rest-versioning.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down

0 comments on commit b469510

Please sign in to comment.