<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta content="text/html; charset=UTF-8" http-equiv="Content-Type"> </head> <body text="#000000" bgcolor="#ffffff"> On 06/16/2010 08:56 PM, Jason L Connor wrote: <blockquote cite="mid:1276736202.2754.6.camel@localhost" type="cite"> <pre wrap="">Hi All, I've put together a document on the wiki describing the practices I think we should adopt for juicer's rest api. <a class="moz-txt-link-freetext" href="https://fedorahosted.org/pulp/wiki/RestfulPractices">https://fedorahosted.org/pulp/wiki/RestfulPractices</a> A couple of caveats: * the document's tone is authoritative, but it is just a draft and open for comments and criticisms. * the document does not reflect the condition of the current api. please don't be fooled by the examples. Please take a look at this document at your earliest convenience. All feedback can be sent to this mailing list. Cheers! </pre> </blockquote> Good info here. Thanks for pulling this together. Few more that we might want to add: * Defining custom exceptions to be propagated down to the clients from specific handlers with Appropriate Error codes and messages. For consumer handler for example can include the following data client can parse and show the user like so: Error Code: 405 Exception: ConsumerException Message: Invalid user credentials trying to create a consumer * localizing the exception before sending down to the clients based on Accept-language header sent from the client would be a good practice. This way client doesnt have to worry about translating them separately. ~ Prad <blockquote cite="mid:1276736202.2754.6.camel@localhost" type="cite"> <pre wrap=""> <fieldset class="mimeAttachmentHeader"></fieldset> _______________________________________________ Pulp-list mailing list <a class="moz-txt-link-abbreviated" href="mailto:Pulp-list@redhat.com">Pulp-list@redhat.com</a> <a class="moz-txt-link-freetext" href="https://www.redhat.com/mailman/listinfo/pulp-list">https://www.redhat.com/mailman/listinfo/pulp-list</a> </pre> </blockquote> </body> </html>