From d2ced3ccbba9c3bf8b1ed778776180bb573db12a Mon Sep 17 00:00:00 2001 From: Denis Kirillov Date: Wed, 26 Oct 2022 17:20:25 +0300 Subject: [PATCH] [#216] Clarify url encoding in README.md Signed-off-by: Denis Kirillov --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 1db3023..5ffc87a 100644 --- a/README.md +++ b/README.md @@ -305,8 +305,9 @@ where `$ATTRIBUTE_NAME` is the name of the attribute we want to use, `$ATTRIBUTE_VALUE` is the value of this attribute that the target object should have. -**NB!** The attribute key and value must be url encoded, i.e., if you want to download an object with the attribute value -`a cat`, the value in the request must be `a+cat`. In the same way with the attribute key. +**NB!** The attribute key and value should be url encoded, i.e., if you want to download an object with the attribute value +`a cat`, the value in the request must be `a+cat`. In the same way with the attribute key. If you don't escape such values +everything can still work (for example you can use `d@ta` without encoding) but it's HIGHLY RECOMMENDED to encode all your attributes. If multiple objects have specified attribute with specified value, then the first one of them is returned (and you can't get others via this interface).