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": "66db9f94-48b8-4557-8a2f-c80cfcf19727",
"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-08-12T15:00:24.2712187Z",
"emailConfirmed": true
},
"sendTime": "2022-08-12T15:00:24.2713187Z",
"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": "df16d735-3061-4eef-9ea1-a717da04e8de",
"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-08-12T15:00:24.2780475Z",
"emailConfirmed": true
},
"sendTime": "2022-08-12T15:00:24.2781203Z",
"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": "768323be-edd8-4d63-a282-3f9a81f0ea76",
"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-08-12T15:00:24.2814155Z",
"emailConfirmed": true
},
"sendTime": "2022-08-12T15:00:24.281524Z",
"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-08-12T15:00:24.2857442Z",
"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-08-12T15:00:24.2865891Z",
"emailConfirmed": true
},
"anotherUserId": "an example string.",
"id": 0,
"discriminator": "an example string.",
"aesKey": "an example string.",
"maxLiveSeconds": 0,
"conversationCreateTime": "2022-08-12T15:00:24.2866765Z",
"displayName": "an example string.",
"displayImagePath": "an example string."
},
"code": 0,
"message": "an example string."
}
Possible Response:
{
"value": {
"users": [
{
"id": 0,
"joinTime": "2022-08-12T15:00:24.2911904Z",
"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-08-12T15:00:24.2920266Z",
"emailConfirmed": true
},
"groupId": 0,
"readTimeStamp": "2022-08-12T15:00:24.2921408Z"
}
],
"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-08-12T15:00:24.2922401Z",
"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-08-12T15:00:24.2974327Z"
}
],
"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!"
}