Skip to content
Permalink
master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
 
 
Cannot retrieve contributors at this time

REST API: GET webhook

This method is used to fetch an existing webhook with the REST API. It uses an HTTP GET request to the following address:

https://api.copernica.com/v3/webhook/$id?access_token=xxxx

Replace the $id with the identifier of the webhook you want to fetch.

Returned fields

Variable Description
ID Unique numerical identifier of the webhook.
handler The URL of the webhook's endpoint that wil handle the call.
trigger The event that will trigger this webhook.
callers An array of the callers that are permitted to trigger the webhook.

JSON example

The JSON for the database might look something like this:

{  
   "ID":"1894",
   "handler":"https://my-webhook-url.com",
   "trigger":"create",
   "callers":["ms", "publisher"]
}

PHP example

The following example demonstrates how to use this method:

// dependencies
require_once("copernica_rest_api.php");

// change this into your access token
$api = new CopernicaRestAPI("your-access-token", 3);

// do the call, and print result
$api->get("webhook/{$id}");

The example above requires the CopernicaRestApi class.

More information