Fetch Endpoint Information

This returns a single endpoint.

Request URL

GEThttps://api.catapult.inetwork.com/v1/users/{userId}/domains/{domainId}/endpoints/{endpointId}


Properties

Property Description
name The endpoint’s name, which SIP clients use as the address of record in the To header when registering. The name must be a valid SIP user or telephone-subscriber string. RFC 3261 Section 19.1.1 defines the characters that are valid in those parts of a SIP URI. Names must be unique within the domain, and cannot be changed after the endpoint is created.
description String to describe endpoint
domainId The id of the domain in which the endpoint will be created. This is the id of the domain resource created in an earlier step.
applicationId The id of the application associated with this endpoint. Application_id is used to determine the callback URL to be used when a client associated with the endpoint attempts to make a call.
enabled When set to true, SIP clients can register as this device to receive and make calls. When set to false, registration, inbound, and outbound calling will not succeed. Default is true.
credentials Contains SIP authentication credentials. See below for details of credentials.
sipUri A SIP URI this device can be contacted at (via INVITE). This property is generated automatically and cannot be changed.

Credentials

Property Description
realm The realm the SIP client must use when authenticating to use this device.
The realm is case-sensitive.
This property is generated automatically and cannot be changed.
username The username the SIP client must use when authenticating to use this device.
The username is case-sensitive.
This property is generated automatically and cannot be changed.
password The plain-text password the SIP client must use when authenticating to use this device.
The password is case-sensitive.
The password must be at least 6 characters long and contain only Latin 1 (ISO 8859-1) characters.

Example 1 of 1: Get a single endpoint

curl -v -X GET https://api.catapult.inetwork.com/v1/users/{userId}/domains/{domain-id}/endpoints/{endpoint-id} \
    -u {token}:{secret} \
    -H "Content-type: application/json"
// Promise
client.Endpoint.get(domainId, endpointId).then(function(endpoint){});

// Callback
client.Endpoint.get(domainId, endpointId, function(err, endpoint){});
var endpoint = await client.Endpoint.GetAsync("{domainId1}", "{endpointId1}");
Console.WriteLine($"{endpoint.Name} - {endpoint.SipUri}");
// jsmith-mobile - jsmith-mobile@doname.bwapp.bwsipp.io
endpoint = domain.get_endpoint("{endpoointId1}")
name = endpoint.name

The above command returns JSON structured like this:

{
    "name" : "jsmith-mobile",
    "description" : "John Smiths mobile client",
    "domainId" : "{domain-id}",
    "applicationId" : "{application-id}",
    "enabled" : "true",
    "sipUri" : "jsmith-mobile@doname.bwapp.bwsipp.io",
    "credentials" : {
        "realm" : "doname.bwapp.bwsipp.io",
        "username" : "jsmith-mobile"
    }
}

results matching ""

    No results matching ""