Documentation is coming. I'm working on putting it all together. It should be there by the 1.5 release at the latest, but hopefully sooner.
Christian -- Christian Hammond - chip...@chipx86.com Review Board - http://www.reviewboard.org VMware, Inc. - http://www.vmware.com 2010/3/7 JohnHenry <qhlonl...@163.com> > Hi, Christian > Is there any document about Reviewboard web api? Or we could learn > through nothing but the 'json.py' souce file? > > Best Regards! > > On 3月7日, 下午1时21分, Christian Hammond <chip...@chipx86.com> wrote: > > Hi everyone, > > > > We've just made some important changes to the web API that will affect > you > > if you use any existing Review Board clients with the upcoming Review > Board > > 1.5. This includes RBTools pre-0.2RC1, post-commit hooks, etc. > > > > First, HTTP status codes for API calls have changed. Previously, API > calls > > would return an HTTP Status 200 if they had any payload data, even for > > errors. Now we use appropriate HTTP status codes for all responses. This > > means that any existing clients that assume that responses will be using > > HTTP Status 200 will need to be updated to be more flexible. > > > > The second change, which is not in just yet, is that most API calls that > > return lists of things (such as review requests or reviews) will now be > > paginated. This means that a query will no longer return all the results, > > but rather will return a set number at a time. > > > > By default, these will return 25 items at a time. This can be changed by > > passing a max-results= parameter to the URL. To grab a new set of items, > you > > can pass start= to the URL to indicate which item to start the query on. > > This is a 0-based index. > > > > New results will be in the JSON payload for pagination: 'total_count', > > 'prev_href', and 'next_href'. The 'prev_href" and 'next_href' keys > provide > > the URLs for querying the next and previous group of batches of data. > > > > These changes will be going in for 1.5 beta 2. It's best that people > start > > porting over anything they've written at their earliest conveniences, > > preferably before the release, in case they run into problems we'd need > to > > fix. > > > > Christian > > > > -- > > Christian Hammond - chip...@chipx86.com > > Review Board -http://www.reviewboard.org > > VMware, Inc. -http://www.vmware.com > > -- > Want to help the Review Board project? Donate today at > http://www.reviewboard.org/donate/ > Happy user? Let us know at http://www.reviewboard.org/users/ > -~----------~----~----~----~------~----~------~--~--- > To unsubscribe from this group, send email to > reviewboard+unsubscr...@googlegroups.com<reviewboard%2bunsubscr...@googlegroups.com> > For more options, visit this group at > http://groups.google.com/group/reviewboard?hl=en -- Want to help the Review Board project? Donate today at http://www.reviewboard.org/donate/ Happy user? Let us know at http://www.reviewboard.org/users/ -~----------~----~----~----~------~----~------~--~--- To unsubscribe from this group, send email to reviewboard+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/reviewboard?hl=en
