4.1.2 Authorize

Authorize

This method allows you to retrieve the login and password for your SIP account.

Authorization

The method requires authorization using basic authentication. Please use the login and password for your operating system.

cURL Request Example

curl --location --request POST 'https://xxxxxxxxxxxx/emcd/authorize.ashx?un=piotr2&up=wielkipiotr' \ --header 'User-Agent: vippie;ios;1.2.3' \ --header 'Content-Type: text/plain' \ --header 'Authorization: Basic YW5kOmFuZDJhMzJkaW0=' \ --data ''

Parameters

Parameter	Description
un	user name - it may be (depending on the authorization policy used) vippie ID, telephone number, SIP login or email address
up	user password

Return value

If successful, we will receive a JSON object containing the login and password for the sip account.
Example:
Response for Generic/RCS
```
{
  "l": "sip-login",
  "p": "sip-pass"
}
```
Response for PBX
```
{
  "l": "sip-login",
  "p": "sip-pass",
  "ext": [
    "10101",
    "10102"
  ]
}
```

If an error occurs on the server or any of the parameters contain an incorrect value, the method will return the appropriate 3-digit error code shown below:

Code	Description
400	Incorrect parameters - one of the parameters was not provided
406	Incorrect login or password
427	SIP account does not exist
445	The account has not been activated yet
451	Too many devices registered for this account
500	Internal server error