aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--externallib.php80
1 files changed, 80 insertions, 0 deletions
diff --git a/externallib.php b/externallib.php
index aa807a7..0430c40 100644
--- a/externallib.php
+++ b/externallib.php
@@ -85,6 +85,86 @@ class local_webhooks_external extends external_api {
* @since Moodle 2.9 Options available
* @since Moodle 2.2
*/
+ public static function search_services_by_event_parameters() {
+ return new external_function_parameters(
+ array(
+ "eventname" => new external_value(PARAM_TEXT, "The name of the event.")
+ )
+ );
+ }
+
+ /**
+ * Search for services that contain the specified event.
+ *
+ * @param string $eventname
+ * @return array
+ * @since Moodle 2.9 Options available
+ * @since Moodle 2.2
+ */
+ public static function search_services_by_event($eventname = "") {
+ $parameters = self::validate_parameters(self::search_services_by_event_parameters(), array("eventname" => $eventname));
+
+ $context = context_system::instance();
+ self::validate_context($context);
+
+ $result = array();
+ if ($listrecords = local_webhooks_search_services_by_event($parameters["eventname"])) {
+ foreach ($listrecords as $index => $record) {
+ $result[$index]["enable"] = $record->enable;
+ $result[$index]["id"] = $record->id;
+ $result[$index]["other"] = $record->other;
+ $result[$index]["title"] = $record->title;
+ $result[$index]["token"] = $record->token;
+ $result[$index]["type"] = $record->type;
+ $result[$index]["url"] = $record->url;
+
+ $result[$index]["events"] = array();
+ foreach ($record->events as $key => $value) {
+ $result[$index]["events"][] = array("name" => $key, "value" => $value);
+ }
+ }
+ }
+
+ return $result;
+ }
+
+ /**
+ * Returns description of method result value.
+ *
+ * @return external_description
+ * @since Moodle 2.2
+ */
+ public static function search_services_by_event_returns() {
+ return new external_multiple_structure(
+ new external_single_structure(
+ array(
+ "id" => new external_value(PARAM_INT, "Service identifier."),
+ "enable" => new external_value(PARAM_INT, "Service status."),
+ "title" => new external_value(PARAM_TEXT, "Name of the service."),
+ "url" => new external_value(PARAM_URL, "URL address."),
+ "type" => new external_value(PARAM_TEXT, "Header type."),
+ "token" => new external_value(PARAM_TEXT, "Authorization key.", VALUE_OPTIONAL),
+ "other" => new external_value(PARAM_TEXT, "Additional field.", VALUE_OPTIONAL),
+ "events" => new external_multiple_structure(
+ new external_single_structure(
+ array(
+ "name" => new external_value(PARAM_TEXT, "Event name."),
+ "value" => new external_value(PARAM_INT, "Observation status.")
+ )
+ ), "Observed events.", VALUE_OPTIONAL
+ )
+ ), "Record about the service."
+ ), "List of services."
+ );
+ }
+
+ /**
+ * Returns description of method parameters.
+ *
+ * @return external_function_parameters
+ * @since Moodle 2.9 Options available
+ * @since Moodle 2.2
+ */
public static function get_record_parameters() {
return new external_function_parameters(
array(