Changes between Version 4 and Version 5 of NDG3/Vocab/RestfulAPI


Ignore:
Timestamp:
13/11/08 06:54:40 (11 years ago)
Author:
lawrence
Comment:

enough for now

Legend:

Unmodified
Added
Removed
Modified
  • NDG3/Vocab/RestfulAPI

    v4 v5  
    1919 
    2020(Note that while we can see some advantages to following some aspects of the Atom protocol, the main concept of a list is not identical to that of a collection, 
    21 so we deviate a little). 
     21so we deviate a little, in particular the payload that one posts to a resource may differ from that which one puts to a resource, the latter being an update, 
     22the former being a creation of a new version completely). 
    2223 
    2324The basic uri space looks like 
     
    6667         * 406 Not Acceptable (syntax of update is broken) 
    6768       * POST creates a new member of the list. Acceptable responses: 
    68          * 202 
    69          * 404 
    70          * 406  
     69         * 202 Accepted for processing 
     70         * 404 Not found (not a valid list) 
     71         * 406 Not Acceptable (syntax of update broken) 
    7172       * DELETE deprecate the memberID. 
    72          * 202 
    73          * 404 
    74          * 406 
     73         * 202 Accepted for processing 
     74         * 404 Not found (not a valid list or member) 
    7575 0. Querys 
    7676   * {{{vocab.ndg.nerc.ac.uk/query?find=string}}}  
    77      * GET should return the URIs of matches as an atom collection, and provide paging should the result set be large.  
    78  
    79   
     77     * GET should return the URIs of matches as an atom collection, and provide paging should the result set be large.   
    8078    
    8179==== Hanging Issues ===== 
     
    8381 * Where to portion the issue associated with a client retrieving a set of updates, and sending back a new set. What if they conflict? 
    8482 * Everything to do with mappings. 
     83 * Ought to consider whether the PUT/POST thing for lists might cause problems in the future.