Bugzilla:BzAPI:HowTo

This page is a repository for tips, tricks, ideas, code samples etc. for the Bugzilla REST API.

Requests

There is no API equivalent of request.cgi, but you can get the same information via the standard search. Use the Boolean Charts, and the fields flag.requestee, flag.setter, product, component and flag to replicate the searches that request.cgi give you, and of course you can add in any other parameters you want to search on.

Flags are not returned in search results, so when you get the results back, make an individual request for each bug, in parallel if you like, to give you a full bug object including the flags. (There is currently no way of getting multiple full bug objects in a single request; if there is demand, we may add this to the API as a special case for searching on bug IDs only.) You can then take this list and filter or present it in whatever way you choose. And because you have the bug objects, you can change the flag fields and submit them back in order to update things.

Example

Here is a simple example using XHR. It will return bugs that were changed in the last day that you were a commenter on.

function test(response)
{
  var a = JSON.parse(response);
  var log = "";
  var bugs = a.bugs;
  var total_bugs = bugs.length;

  for (var i = 0; i < total_bugs; i++) {
    log += bugs[i].id + " " + bugs[i].summary + "\n";
  }

  alert(log);
}

function handler() {
 if(this.readyState == 4 && this.status == 200) {
  test(this.responseText);
 }
 // handle error cases... blah blah.
}

function getNewBugs()
{
  var your_bugzilla_login = "mozbugz@dougt.org";

  var client = new XMLHttpRequest();
  client.onreadystatechange = handler;
  client.open("GET",
              "https://api-dev.bugzilla.mozilla.org/0.2/bug?email1=" +
              your_bugzilla_login +
              "&email1_type=equals_any&email1_comment_author=1" +
              "&chfieldfrom=1d\&chfieldto=Now");

  // set the accept header so that the bugzilla rest api knows what to return
  client.setRequestHeader('Accept','text/json');
  client.send();
}