Querying Phabricator using Conduit

Author
Created	7 September 2017 01:42:07
Last Modified	7 September 2017 14:25:07
Tags	Phabricator

Motivation: I would like to be able to visualize the relationships between a set of tasks in Phabricator. That is, for a set of tasks, I want a directed graph showing the parent task/subtask relationships. Nodes should be labeled with the task name. Status of the task should be indicted by the node color. And projects associated with the task should be visible as a tooltip. Eventually, highlighting nodes by project should be possible.

It should be straightforward to display that in a force-directed graph using D3 (examples) with information queried using the Conduit Phabricator API. The following shows how the required data would be queried.

Visit https://phabricator.wikimedia.org/conduit/method/maniphest.search/. In the query form, fill in:

constraints	{"parentIDs": [174043]}
attachments	{"projects": true}

This finds all of the subtasks of T174043 and lists their information including the internal ids of the project tags, which could then also be queried.

The names of the projects can then be found by visiting https://phabricator.wikimedia.org/conduit/method/project.search/. In the query form, fill in:

constraints	{{"phids": ["PHID-PROJ-m7f7bw4ri4xwgnzi7vnt"]}

where the phids are taken from the project tag ids in the results of the previous query.

To create a Coduit API token to be able to make the queries above from scripts or programmatically, visit https://phabricator.wikimedia.org/settings/user/<phabricator user id>/page/apitokens/.

A PHP program to perform the query above is:

<?php

define('__ROOT__', '/usr/share/libphutil/src/');
require_once(__ROOT__.'__phutil_library_init__.php');


$api_token = "<insert Conduit API token here>";
$api_parameters = [
	  'constraints' => [
		      'phids' => [
			            'PHID-PROJ-m7f7bw4ri4xwgnzi7vnt'
			],
		],
	];

$client = new ConduitClient('https://phabricator.wikimedia.org/');
$client->setConduitToken($api_token);

$result = $client->callMethodSynchronous('project.search', $api_parameters);