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 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
> > if you use any existing Review Board clients with the upcoming Review
> > 1.5. This includes RBTools pre-0.2RC1, post-commit hooks, etc.
> > First, HTTP status codes for API calls have changed. Previously, API
> > 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,
> > 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
> > 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
> > porting over anything they've written at their earliest conveniences,
> > preferably before the release, in case they run into problems we'd need
> > 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
> Happy user? Let us know at http://www.reviewboard.org/users/
> To unsubscribe from this group, send email to
> For more options, visit this group at
Want to help the Review Board project? Donate today at
Happy user? Let us know at http://www.reviewboard.org/users/
To unsubscribe from this group, send email to
For more options, visit this group at