Difference between revisions of "MOR API device create"
From Kolmisoft Wiki
Jump to navigationJump to search
| Line 52: | Line 52: | ||
<status>Device created</status> | <status>Device created</status> | ||
<id>8</id> | <id>8</id> | ||
</page> | |||
</body> | |||
**We send: | |||
***http://123.123.123.123/billing/api/device_create?u=admin&p=admin1&user_id=2&type=FAX&description=desription1&pin=12366&devicegroup_id=4&hash=318fce896bf3c552ef2b3a638e0d28f7d41026a3 | |||
**We get: | |||
<head></head> | |||
<body> | |||
<page> | |||
<status>Device created</status> | |||
<id>13</id> | |||
</page> | </page> | ||
</body> | </body> | ||
**Now we can find | **Now we can find these Devices in GUI Devices list. | ||
'''* Note that username and password are not included in hash''' | '''* Note that username and password are not included in hash''' | ||
Revision as of 07:10, 7 December 2012
MOR API
Create device
- Call: /api/device_create
- Methods: POST, GET(if allowed, not recomended)
- Params:
- user_id - User ID in MOR database, for which user device should be created. Required.
- u - username to login. Required.
- p - password to login. Required.
- hash - SHA1 hash constructed using params and API_Secret_Key ( More described in Constructing hash). Required.
- description - string
- pin - [number. ]. If pin param not send -> random_numbers . If blank -> pinless
- type - Device type [SIP, IAX2, FAX, Virtual,H323, ZAP, Skype, ]. When is -> default device type. If default device type is empty -> 'SIP'
- devicegroup_id - device group ID
- Returns:
- Success
- <status>Device was created</status>
- Errors:
- <error>User was not found</error> - User was not found using user_id. Use correct user id.
- <error>Incorrect hash</error> - Hash was not correct. Check API_Secret_Key and order or params while concatenating hash_string.
- <error>Dont be so smart</error> - User with UNIQUEHASH not found or params id not send. Enter correct id.
- <error>Device_type_invalid</error> - Enter correct type.
- <error>Device_group_invalid</error> - Device group with id not found. Enter group id.
- <error>Pin_is_already_used</error> - Enter onother pin.
- <error>Pin_must_be_numeric</error> - Enter correct pin.
- <error>Device was not created</error>
- <message>problem message</message>
- Success
Request
- admin - owner's username
- password - owner's password
- user_id - for which user device should be created
- Example:
- We have user_id = 2, API Secret Key = secret
- Hash string: "6e79d4a82f68102f43be11d873177f47817f84df"
- We send:
- We get:
<head></head>
<body>
<page>
<status>Device created</status>
<id>8</id>
</page>
</body>
<head></head>
<body>
<page>
<status>Device created</status>
<id>13</id>
</page>
</body>
- Now we can find these Devices in GUI Devices list.
* Note that username and password are not included in hash
