HTTP Binding Proposals Questions and Examples Group Name

HTTP Binding Proposals, Questions, and Examples Group Name: WG 3 Source: Phillip Brown, Inter. Digital Meeting Date: 2014 -07 -28 (PRO#12. 0) Agenda Item: HTTP Binding

Proposals 1. one. M 2 M should define a HTTP header field for M 2 M-Request-ID (e. g. X-M 2 M-RI) – Would avoid having to decode HTTP Content on intermediate CSEs – Would allow M 2 M-Request-ID to be carried in HTTP header of both requests and responses in a symmetric fashion – Nicely aligned with Co. AP ‘Token’ header option 2. one. M 2 M should use URI Query String to carry at least rt and nm request parameters – Probably should consider other request parameters as well E. g. rt, nm, ot, rqet, rset, oet, rp, rc, ec, da, gid, fc, Disrestype © 2013 one. M 2 M Partners <Document number> 2

Example: HTTP Binding of Create <remote. CSE> Request: Method: POST URI: http: //cse 01. m 2 m. sp 1. com/CSE 01 Base? rt=remote. CSE&nm=remote. CSE 02 From: http: //cse 02. m 2 m. sp 1. com X-M 2 M-RI: 0001 Content-Type: application/xml Content-Length: length of Content: <remote. CSE> representation one. M 2 M Request Parameter HTTP Binding Operation (op) HTTP Method To (to) HTTP URI Resource Type (rt) HTTP URI Query String Parameter (rt) Name (nm) HTTP URI Query String Parameter (nm) From (fr) HTTP From Header Field M 2 M Request Identifier (ri) New one. M 2 M HTTP X-M 2 M-RI Header Field Content (cn) HTTP Content, Content-Length, Content-Type Header Fields *** Other optional one. M 2 M request parameters not shown can be carried in HTTP URI Query String or in one. M 2 M defined HTTP header fields (e. g. ot, rqet, rset, oet, rp, rc, ec, da, gid, fc, Disrestype)

Example: HTTP Binding of Create <remote. CSE> Response: Status: 201 Created X-M 2 M-RI: 0001 Location: http: //cse 01. m 2 m. sp 1. com/CSE 01 Base/remote. CSE 02 Content-Type: application/xml Content-Length: length of Content: <remote. CSE> representation + possible response parameters ETag: “ 7845739” one. M 2 M Response Parameter HTTP Binding Response Code (rs) HTTP Method M 2 M Request Identifier (ri) New one. M 2 M HTTP X-M 2 M-RI Header Field Address of Content Created (not currently defined as a one. M 2 M response parameter) HTTP Location Header Field Content (cn) HTTP Content, Content-Length, Content-Type Header Fields *** Other optional one. M 2 M response parameters not shown can be carried in HTTP Content or possibly one. M 2 M defined HTTP header fields (e. g. to, from, ot, rset, cs, ra)

Questions? 1. Should one. M 2 M consider defining any other HTTP header fields? – E. g. For response parameters that do not map to existing HTTP header fields since responses do not have URI query string like requests 2. Which one. M 2 M request or response parameters (if any) are better suited to be carried in HTTP content vs. header fields? © 2013 one. M 2 M Partners <Document number> 5

More Detailed Examples… The following slides show one. M 2 M/HTTP Procedures: 1. CSE-CSE Registration/De-Registration 2. AE-CSE Registration/De-Registration 3. Container Create/Retrieve/Update/Delete © 2013 one. M 2 M Partners <Document number> 6