>>>>> "Chris" == Chris Travers <chris.trav...@gmail.com> writes:
    Chris> Hi all;

    Chris> I am just about to start on  a web services wrapper for 1.4.
    Chris> Reviewing the past discussions on this, I want to just submit my
    Chris> proposal for review before I get started.  What I expect to start on
    Chris> is very simple.


    Chris> URL would be of the format of:

    Chris> [lsmb_base_url]/rest/company_name/[major version]/[top level
    Chris> object][/id][/resourcetype/][.extension]?argstring

[major version] should start with a letter, probably "v", not just be a number.
It's estetic, but I found it useful. e.g:
     /rest/company/v1/blah

rather than
     /rest/company/1/blah

    Chris> "rest" would be a reserved word and not usable for any later part of
    Chris> the API.  I.e. it can never be a valid object name, resource type, 
id,
    Chris> or object class name.  We'd use it to automatically determine where
    Chris> the path starts.

We need this because the "base_url" might be arbitrarily long, and we
don't want to configure it into the code?

    Chris> The payload would then be handed off to the format handler and reset
    Chris> as a hashref returned from the from_input routine.

This all sounds great to me.
I like that the input/output is seperated, should make for every nice
unit testing.

-- 
]       He who is tired of Weird Al is tired of life!           |  firewalls  [
]   Michael Richardson, Sandelman Software Works, Ottawa, ON    |net architect[
] m...@sandelman.ottawa.on.ca http://www.sandelman.ottawa.on.ca/ |device driver[
   Kyoto Plus: watch the video <http://www.youtube.com/watch?v=kzx1ycLXQSE>
                       then sign the petition. 

------------------------------------------------------------------------------
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
_______________________________________________
Ledger-smb-devel mailing list
Ledger-smb-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/ledger-smb-devel

Reply via email to