[wp-trac] [WordPress Trac] #35086: Use short CURIEs instead of full URIs

WordPress Trac noreply at wordpress.org
Mon Dec 14 23:01:22 UTC 2015


#35086: Use short CURIEs instead of full URIs
-------------------------+-------------------------
 Reporter:  rmccue       |      Owner:
     Type:  enhancement  |     Status:  new
 Priority:  normal       |  Milestone:  4.5
Component:  REST API     |    Version:
 Severity:  normal       |   Keywords:  needs-patch
  Focuses:               |
-------------------------+-------------------------
 One small annoyance in the API right now is that link relations are full
 URIs. In JavaScript, this means that while you have  `_links.self` and
 `_links.author`, you have to do `_links["http://v2.wp-api.org/term"]`.
 This is a bit ugly, and can be confusing.

 We should instead switch to [https://en.wikipedia.org/wiki/CURIE CURIEs].
 These are an abbreviated form of the full URI that's easier to work with,
 but can be expanded out to the full URI if needed. They look like this:

 {{{
 {
     "_links": {
         "curies": [
             {
                 "name": "wp",
                 "href": "http://v2.wp-api.org/{rel}",
                 "templated": true
             }
         ],

         "wp:term": [
             {
                 "taxonomy": "category",
                 "href": "..."
             },
             {
                 "taxonomy": "post_tag",
                 "href": "..."
             }
         ]
     }
 }
 }}}

 Originally https://github.com/WP-API/WP-API/issues/1488

--
Ticket URL: <https://core.trac.wordpress.org/ticket/35086>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform


More information about the wp-trac mailing list