From efbb9cfb7b6ebc8a0c724d103c6e1063e049f205 Mon Sep 17 00:00:00 2001
From: Stan Hu <stanhu@gmail.com>
Date: Wed, 18 Oct 2017 16:35:37 -0700
Subject: Document converting `+` to `%2B` in an API query parameter

[ci skip]
---
 doc/api/README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

(limited to 'doc/api')

diff --git a/doc/api/README.md b/doc/api/README.md
index 3fd4c97e536..1ec85b71213 100644
--- a/doc/api/README.md
+++ b/doc/api/README.md
@@ -441,6 +441,23 @@ Content-Type: application/json
 }
 ```
 
+## Encoding `+` in ISO 8601 dates
+
+If you need to include a `+` in a query parameter, you may need to use `%2B` instead due
+a [W3 recommendation]((http://www.w3.org/Addressing/URL/4_URI_Recommentations.html) that
+causes a `+` to be interpreted as a space. For example, in an ISO 8601 date, you may want to pass
+a time in Mountain Standard Time, such as:
+
+```
+2017-10-17T23:11:13.000+05:30
+```
+
+The correct encoding for the query parameter would be:
+
+```
+2017-10-17T23:11:13.000%2B05:30
+```
+
 ## Clients
 
 There are many unofficial GitLab API Clients for most of the popular
-- 
cgit v1.2.1