Devices
Catalog
POST Add device
Request path:
https://server.kahla.app/Devices/AddDevice
Request example:
https://server.kahla.app/Devices/AddDevice?Name=yourName&PushEndpoint=yourPushEndpoint&PushP256DH=yourPushP256DH&PushAuth=yourPushAuth
Request content type:
application/x-www-form-urlencoded
Form content example:
Name=yourName&PushEndpoint=yourPushEndpoint&PushP256DH=yourPushP256DH&PushAuth=yourPushAuth
Request form:
Name | Required | Type |
---|---|---|
Name | Required | Text |
PushEndpoint | Required | Text |
PushP256DH | Required | Text |
PushAuth | Required | Text |
Possible Response:
{
"value": 0,
"code": 0,
"message": "an example string."
}
Possible Response:
{
"code": -1,
"message": "Some error."
}
Possible Response:
{
"items": [
"Some item is invalid!"
],
"code": -10,
"message": "Your input contains several errors!"
}
POST Update device
Request path:
https://server.kahla.app/Devices/UpdateDevice
Request example:
https://server.kahla.app/Devices/UpdateDevice?DeviceId=0&Name=yourName&PushEndpoint=yourPushEndpoint&PushP256DH=yourPushP256DH&PushAuth=yourPushAuth
Request content type:
application/x-www-form-urlencoded
Form content example:
DeviceId=0&Name=yourName&PushEndpoint=yourPushEndpoint&PushP256DH=yourPushP256DH&PushAuth=yourPushAuth
Request form:
Name | Required | Type |
---|---|---|
DeviceId | Required | Number |
Name | Required | Text |
PushEndpoint | Required | Text |
PushP256DH | Required | Text |
PushAuth | Required | Text |
Possible Response:
{
"value": {
"id": 0,
"name": "an example string.",
"ipAddress": "an example string.",
"userId": "an example string.",
"addTime": "2022-05-27T06:36:01.3627719Z"
},
"code": 0,
"message": "an example string."
}
Possible Response:
{
"code": -1,
"message": "Some error."
}
Possible Response:
{
"items": [
"Some item is invalid!"
],
"code": -10,
"message": "Your input contains several errors!"
}
GET My devices
Request path:
https://server.kahla.app/Devices/MyDevices
Request example:
https://server.kahla.app/Devices/MyDevices
Possible Response:
{
"items": [
{
"id": 0,
"name": "an example string.",
"ipAddress": "an example string.",
"userId": "an example string.",
"addTime": "2022-05-27T06:36:01.3646105Z"
}
],
"code": 0,
"message": "an example string."
}
Possible Response:
{
"code": -1,
"message": "Some error."
}
Possible Response:
{
"items": [
"Some item is invalid!"
],
"code": -10,
"message": "Your input contains several errors!"
}
POST Drop device
Request path:
https://server.kahla.app/Devices/DropDevice
Request example:
https://server.kahla.app/Devices/DropDevice?id=0
Request content type:
application/x-www-form-urlencoded
Form content example:
id=0
Request form:
Name | Required | Type |
---|---|---|
id | Required | Number |
Possible Response:
{
"code": -1,
"message": "Some error."
}
Possible Response:
{
"items": [
"Some item is invalid!"
],
"code": -10,
"message": "Your input contains several errors!"
}
POST Push test message
Request path:
https://server.kahla.app/Devices/PushTestMessage
Request example:
https://server.kahla.app/Devices/PushTestMessage
Request content type:
application/x-www-form-urlencoded
Form content example:
Possible Response:
{
"code": -1,
"message": "Some error."
}
Possible Response:
{
"items": [
"Some item is invalid!"
],
"code": -10,
"message": "Your input contains several errors!"
}