From bf027d291bd1607d46134a10cbab7cef621032fd Mon Sep 17 00:00:00 2001 From: apidesigner Date: Tue, 31 Jan 2017 11:03:22 +0000 Subject: [PATCH] Updates core-principles/versioning.md Auto commit by GitBook Editor --- core-principles/versioning.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/core-principles/versioning.md b/core-principles/versioning.md index 3206808..bc2bf01 100644 --- a/core-principles/versioning.md +++ b/core-principles/versioning.md @@ -25,6 +25,9 @@ A change to _resource identifier_, _resource metadata_, _resource actions_ and _ A change to _representation format_ SHOULD NOT result into a new resource variant. +#### Example +Currently optional URI Query parameter `first` on an existing resource `/greeting?first=John&last=Appleseed` needs to be made required. Since this change violates the 3rd rule of extending and could break existing clients a new variant of the resource is created with different URI `/named-greeting?first=John&last=Appleseed`. + ### Representation Format Change > A representation format is the serialization format (media type) used in request and response bodies and typically it represents a resource or its part, possibly with additional hypermedia controls.