Setup on a generic PHP client site

Instructions to set up any site to be able to query data from the Encyclopedia of World Problems and Human Potential (EWPHP).

Requirements

The following demo code and output are in PHP and make use of cURL. Obviously, an alternative could be written in virtually any other programming language.

Remote authentication

Before we can retrieve any data, we do a remote login into the Drupal 7 site, get a session cookie (based on the session name and the session id), and then do any number of authenticated requests.

As for the service username and password: use the credentials received from an EWPHP representative (describe your motivation and place a request at https://edit.ewphp.org/en/contact).

<?php
// Let's log in to remotely to https://edit.ewphp.org

$endpoint_url = 'https://edit.ewphp.org/en/api/1.0';

$service_url = $endpoint_url . '/user/login';
// Use the credentials received from an EWPHP representative, or place a request via https://edit.ewphp.org/en/contact
$post_data = array(
  'username' => 'USERNAME',
  'password' => 'PASSWORD',
);
$post_data = http_build_query($post_data, '', '&'); // Format post data as application/x-www-form-urlencoded

// Set up the request
$curl = curl_init($service_url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); // Have curl_exec return a string

curl_setopt($curl, CURLOPT_POST, true); // Do a POST
curl_setopt($curl, CURLOPT_POSTFIELDS, $post_data); // POST this data

// Make the request
curl_setopt($curl, CURLOPT_VERBOSE, true); // Output to command line
$response = curl_exec($curl);
curl_close($curl);
// var_dump($response); // Debugging

// Parse the response
$xml = new SimpleXMLElement($response);
$session_cookie = $xml->session_name .'='. $xml->sessid;
//print "SESSION_COOKIE: $session_cookie"; // Debugging

// Possibly store the session cookie in a text file for later (re)use.
//file_put_contents('session_cookie.txt', $session_cookie);
?>

Query remote data

Once we have a $session_cookie, we can do autheticated requests to query and retrieve the remote data.

Note that the data can be requested in the following formats: bencode, json, jsonp, php, and xml. Just specify the extension of "entity_node" in the code snippets below. If no extension is specified, ".xml" is assumed.

Get a list of nodes

In the following example we will retrieve a information 10 published nodes of content type "problem" in English language, sorted descending by the date of last change. Instead of all fields we only ask for fields "changed" and "title". If we need the next page in the list, we simply increase the number assigned to parameter "page".

<?php
// To get a $session_cookie, use the code as above

// Let's do one or any number of authenticated requests

$service_url = $endpoint_url . '/entity_node.json?parameters[type]=problem&parameters[language]=en&parameters[status]=1&page=0&pagesize=10&sort=changed&direction=DESC&fields=changed,title'; // .json asks for JSON data in response

// If stored, retrieve the cookie session information.
//$session_cookie = file_get_contents('session_cookie.txt');

// Set up the request
$curl = curl_init($service_url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); // Have curl_exec return a string

curl_setopt($curl, CURLOPT_COOKIE, "$session_cookie"); // Use the previously saved session

// Make the request
curl_setopt($curl, CURLOPT_VERBOSE, true); // Output to command line
$response = curl_exec($curl);
curl_close($curl);
// var_dump($response); // Debugging

if ($response){
  $result = json_decode($response, TRUE);
  echo '<ul>';
  foreach ($result as $val){
    echo '<li>' . $val['title'] . ' (' . date( 'Y-m-d H:i:s', $val['changed'] ) . ')' . '</li>';
  }
  echo '</ul>';
}
?>

Vulnerable species of Agaricomycetes (2022-05-16 22:09:59)
Threatened species of Ephemera [2] (2022-05-16 22:09:49)
Threatened species of Lagurus [2] (2022-05-16 22:09:41)
Domestic terrorism (2022-05-16 22:09:07)
Institutional lying (2022-05-14 13:11:28)
Philanthrocapitalism (2022-05-14 13:05:38)
Enforced vaccination (2022-05-14 13:02:12)
Governance by emergency (2022-05-14 13:00:15)
Disease mongering (2022-05-14 12:58:34)
Human immunodeficiency virus infection (2022-05-14 12:45:17)

Get one full node

To get all data for a given published node (identified by parameter "nid"), we can proceed as follows.

<?php
// To get a $session_cookie, use the code as above

// Let's do one or any number of authenticated requests

$service_url = $endpoint_url . '/entity_node.json?parameters[status]=1&parameters[nid]=132936'; // .json asks for JSON data in response

// If stored, retrieve the cookie session information.
//$session_cookie = file_get_contents('session_cookie.txt');

// Set up the request
$curl = curl_init($service_url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); // Have curl_exec return a string

curl_setopt($curl, CURLOPT_COOKIE, "$session_cookie"); // Use the previously saved session

// Make the request
curl_setopt($curl, CURLOPT_VERBOSE, true); // Output to command line
$response = curl_exec($curl);
curl_close($curl);
// var_dump($response); // Debugging

if ($response){
  $result = json_decode($response);
  echo '<pre>';
  print_r($result);
  echo '</pre>';
}
?>