/**
* Get a list of applications available for connections.
*
* @param array $params
* @return array
* @throws API_Exception
* @throws CRM_Core_Exception
* @throws \Civi\Cxn\Rpc\Exception\InvalidMessageException
*/
function civicrm_api3_cxn_app_get($params)
{
// You should not change CIVICRM_CXN_APPS_URL in production; this is for local development.
$url = defined('CIVICRM_CXN_APPS_URL') ? CIVICRM_CXN_APPS_URL : \Civi\Cxn\Rpc\Constants::OFFICIAL_APPMETAS_URL;
list($headers, $blob, $code) = CRM_Cxn_CiviCxnHttp::singleton()->send('GET', $url, '');
if ($code != 200) {
throw new API_Exception("Failed to download application list.");
}
$agent = new \Civi\Cxn\Rpc\Agent(NULL, NULL);
$agent->setCertValidator(CRM_Cxn_BAO_Cxn::createCertificateValidator());
$message = $agent->decode(array(AppMetasMessage::NAME, GarbledMessage::NAME), $blob);
if ($message instanceof AppMetasMessage) {
return _civicrm_api3_basic_array_get('CxnApp', $params, $message->getData(), 'appId', array('appId', 'appUrl', 'desc', 'appCert', 'perm'));
} elseif ($message instanceof GarbledMessage) {
return civicrm_api3_create_error('Received garbled response', array('garbled_message' => $message->getData()));
} else {
return civicrm_api3_create_error("Unrecognized message");
}
}
