Conversation
Catalog
GET All
Request path:
https://server.kahla.app/Conversation/All
Request example:
https://server.kahla.app/Conversation/All
Possible Response:
{
"items": [
{
"displayName": "an example string.",
"displayImagePath": "an example string.",
"latestMessage": {
"id": "fb64591e-e197-4cab-b708-82859603effc",
"conversationId": 0,
"ats": [
{
"targetUserId": "an example string."
}
],
"senderId": "an example string.",
"sender": {
"markEmailPublic": true,
"themeId": 0,
"email": "an example string.",
"enableEmailNotification": true,
"enableEnterToSendMessage": true,
"enableInvisiable": true,
"listInSearchResult": true,
"isOnline": true,
"id": "an example string.",
"bio": "an example string.",
"nickName": "an example string.",
"sex": "an example string.",
"iconFilePath": "an example string.",
"preferedLanguage": "an example string.",
"accountCreateTime": "2022-05-27T06:36:01.3324506Z",
"emailConfirmed": true
},
"sendTime": "2022-05-27T06:36:01.3325441Z",
"content": "an example string.",
"read": true,
"groupWithPrevious": true
},
"unReadAmount": 0,
"conversationId": 0,
"discriminator": "an example string.",
"userId": "an example string.",
"aesKey": "an example string.",
"muted": true,
"someoneAtMe": true,
"online": true
}
],
"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 Get message
Request path:
https://server.kahla.app/Conversation/GetMessage
Request example:
https://server.kahla.app/Conversation/GetMessage?id=0&take=0&skipFrom=yourskipFrom
Request arguments:
Name | Required | Type |
---|---|---|
id | Required | Number |
take | Not required | Number |
skipFrom | Not required | Text |
Possible Response:
{
"items": [
{
"id": "e7b1cdac-9fd8-4318-be00-0bee7b99faa8",
"conversationId": 0,
"ats": [
{
"targetUserId": "an example string."
}
],
"senderId": "an example string.",
"sender": {
"markEmailPublic": true,
"themeId": 0,
"email": "an example string.",
"enableEmailNotification": true,
"enableEnterToSendMessage": true,
"enableInvisiable": true,
"listInSearchResult": true,
"isOnline": true,
"id": "an example string.",
"bio": "an example string.",
"nickName": "an example string.",
"sex": "an example string.",
"iconFilePath": "an example string.",
"preferedLanguage": "an example string.",
"accountCreateTime": "2022-05-27T06:36:01.3397155Z",
"emailConfirmed": true
},
"sendTime": "2022-05-27T06:36:01.3397866Z",
"content": "an example string.",
"read": true,
"groupWithPrevious": true
}
],
"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 Send message
Request path:
https://server.kahla.app/Conversation/SendMessage
Request example:
https://server.kahla.app/Conversation/SendMessage?Id=0&Content=yourContent&At[0]=yourAt&At[1]=yourAt&At[2]=yourAt&MessageId=yourMessageId
Request content type:
application/x-www-form-urlencoded
Form content example:
Id=0&Content=yourContent&At[0]=yourAt&At[1]=yourAt&At[2]=yourAt&MessageId=yourMessageId
Request form:
Name | Required | Type |
---|---|---|
Id | Required | Number |
Content | Required | Text |
At | Not required | Text Collection |
MessageId | Required | Text |
Possible Response:
{
"value": {
"id": "7d35405b-401b-45fe-8e48-0c5d979f591d",
"conversationId": 0,
"ats": [
{
"targetUserId": "an example string."
}
],
"senderId": "an example string.",
"sender": {
"markEmailPublic": true,
"themeId": 0,
"email": "an example string.",
"enableEmailNotification": true,
"enableEnterToSendMessage": true,
"enableInvisiable": true,
"listInSearchResult": true,
"isOnline": true,
"id": "an example string.",
"bio": "an example string.",
"nickName": "an example string.",
"sex": "an example string.",
"iconFilePath": "an example string.",
"preferedLanguage": "an example string.",
"accountCreateTime": "2022-05-27T06:36:01.3429466Z",
"emailConfirmed": true
},
"sendTime": "2022-05-27T06:36:01.3430128Z",
"content": "an example string.",
"read": true,
"groupWithPrevious": true
},
"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 Conversation detail
Request path:
https://server.kahla.app/Conversation/ConversationDetail
Request example:
https://server.kahla.app/Conversation/ConversationDetail?id=0
Request arguments:
Name | Required | Type |
---|---|---|
id | Required | Number |
Possible Response:
{
"value": {
"requesterId": "an example string.",
"requestUser": {
"markEmailPublic": true,
"themeId": 0,
"email": "an example string.",
"enableEmailNotification": true,
"enableEnterToSendMessage": true,
"enableInvisiable": true,
"listInSearchResult": true,
"isOnline": true,
"id": "an example string.",
"bio": "an example string.",
"nickName": "an example string.",
"sex": "an example string.",
"iconFilePath": "an example string.",
"preferedLanguage": "an example string.",
"accountCreateTime": "2022-05-27T06:36:01.3469908Z",
"emailConfirmed": true
},
"targetId": "an example string.",
"targetUser": {
"markEmailPublic": true,
"themeId": 0,
"email": "an example string.",
"enableEmailNotification": true,
"enableEnterToSendMessage": true,
"enableInvisiable": true,
"listInSearchResult": true,
"isOnline": true,
"id": "an example string.",
"bio": "an example string.",
"nickName": "an example string.",
"sex": "an example string.",
"iconFilePath": "an example string.",
"preferedLanguage": "an example string.",
"accountCreateTime": "2022-05-27T06:36:01.3478399Z",
"emailConfirmed": true
},
"anotherUserId": "an example string.",
"id": 0,
"discriminator": "an example string.",
"aesKey": "an example string.",
"maxLiveSeconds": 0,
"conversationCreateTime": "2022-05-27T06:36:01.3479222Z",
"displayName": "an example string.",
"displayImagePath": "an example string."
},
"code": 0,
"message": "an example string."
}
Possible Response:
{
"value": {
"users": [
{
"id": 0,
"joinTime": "2022-05-27T06:36:01.3522077Z",
"muted": true,
"userId": "an example string.",
"user": {
"markEmailPublic": true,
"themeId": 0,
"email": "an example string.",
"enableEmailNotification": true,
"enableEnterToSendMessage": true,
"enableInvisiable": true,
"listInSearchResult": true,
"isOnline": true,
"id": "an example string.",
"bio": "an example string.",
"nickName": "an example string.",
"sex": "an example string.",
"iconFilePath": "an example string.",
"preferedLanguage": "an example string.",
"accountCreateTime": "2022-05-27T06:36:01.3530008Z",
"emailConfirmed": true
},
"groupId": 0,
"readTimeStamp": "2022-05-27T06:36:01.3530754Z"
}
],
"groupImagePath": "an example string.",
"groupName": "an example string.",
"listInSearchResult": true,
"hasPassword": false,
"ownerId": "an example string.",
"id": 0,
"discriminator": "an example string.",
"aesKey": "an example string.",
"maxLiveSeconds": 0,
"conversationCreateTime": "2022-05-27T06:36:01.3531699Z",
"displayName": "an example string.",
"displayImagePath": "an example string."
},
"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 File history
Request path:
https://server.kahla.app/Conversation/FileHistory
Request example:
https://server.kahla.app/Conversation/FileHistory?id=0&skipDates=0
Request arguments:
Name | Required | Type |
---|---|---|
id | Required | Number |
skipDates | Required | Number |
Possible Response:
{
"showingDateUTC": "an example string.",
"siteName": "an example string.",
"rootPath": "an example string.",
"items": [
{
"fileName": "an example string.",
"fileSize": 0,
"uploadTime": "2022-05-27T06:36:01.3582953Z"
}
],
"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 message life time
Request path:
https://server.kahla.app/Conversation/UpdateMessageLifeTime
Request example:
https://server.kahla.app/Conversation/UpdateMessageLifeTime?Id=0&NewLifeTime=0
Request content type:
application/x-www-form-urlencoded
Form content example:
Id=0&NewLifeTime=0
Request form:
Name | Required | Type |
---|---|---|
Id | Required | Number |
NewLifeTime | Required | Number |
Possible Response:
{
"code": -1,
"message": "Some error."
}
Possible Response:
{
"items": [
"Some item is invalid!"
],
"code": -10,
"message": "Your input contains several errors!"
}