php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-11-16 06:17:56 +08:00
Code Issues Packages Projects Releases Wiki Activity

Fixed rest-versioning.md

Browse Source
This commit is contained in:
Ilya Sevostyanov
2016-02-03 10:26:11 +03:00
parent 6d28678433
commit b469510eee
1 changed files with 2 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/guide-ru/rest-versioning.md
View File

@@ -8,21 +8,13 @@ API используются клиентами, код которых вы не
продолжать использовать старую, совместимую с ними версию API. Новые или обновлённые клиенты могут использовать новую продолжать использовать старую, совместимую с ними версию API. Новые или обновлённые клиенты могут использовать новую
версию. версию.
> Tip: Чтобы узнать больше о выборе версий обратитесь к [Semantic Versioning](http://semver.org/).
Общей практикой при реализации версионирования API является включение номера версии в URL-адрес вызова API-метода. Общей практикой при реализации версионирования API является включение номера версии в URL-адрес вызова API-метода.
Например, `http://example.com/v1/users` означает вызов API `/users` версии 1. Другой способ версионирования API, Например, `http://example.com/v1/users` означает вызов API `/users` версии 1. Другой способ версионирования API,
получивший недавно широкое распространение, состоит в добавлении номера версии в HTTP-заголовки запроса, получивший недавно широкое распространение, состоит в добавлении номера версии в HTTP-заголовки запроса,
обычно в заголовок `Accept`: обычно в заголовок `Accept`:
> Tip: Чтобы узнать больше о выборе версий обратитесь к [Semantic Versioning](http://semver.org/).
Один из типичных способов реализации версионирования — указание версии в URL. Например, `http://example.com/v1/users`
соответствует `/users` версии 1.
Ещё один способ, ставший сейчас популярным — передача версии через заголовок HTTP. Чаще всего для этого используется
заголовок `Accept`:
``` ```
// как параметр // как параметр
Accept: application/json; version=v1 Accept: application/json; version=v1