Conversation

Catalog

• All
• Get message
• Send message
• Conversation detail
• Update message life time

---

GET Authorize All

Request path:

https://staging.server.kahla.app/Conversation/AllCopyTry

Request example:

https://staging.server.kahla.app/Conversation/All

Possible Response:

{
  "items": [
    {
      "displayName": "an example string.",
      "displayImagePath": "an example string.",
      "latestMessage": "an example string.",
      "latestMessageTime": "2019-08-25T21:00:44.6038663Z",
      "unReadAmount": 0,
      "conversationId": 0,
      "discriminator": "an example string.",
      "userId": "an example string.",
      "aesKey": "an example string.",
      "muted": true,
      "someoneAtMe": 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 Authorize Get message

Request path:

https://staging.server.kahla.app/Conversation/GetMessageCopyTry

Request example:

https://staging.server.kahla.app/Conversation/GetMessage?id=0&skipTill=0&take=0

Request arguments:

Name	Required	Type
id	Required	Number
skipTill	Not required	Number
take	Not required	Number

Possible Response:

{
  "items": [
    {
      "id": 0,
      "conversationId": 0,
      "ats": [
        {
          "targetUserId": "an example string."
        }
      ],
      "senderId": "an example string.",
      "sender": {
        "makeEmailPublic": true,
        "themeId": 0,
        "email": "an example string.",
        "enableEmailNotification": true,
        "id": "an example string.",
        "bio": "an example string.",
        "nickName": "an example string.",
        "sex": "an example string.",
        "headImgFileKey": 0,
        "iconFilePath": "an example string.",
        "preferedLanguage": "an example string.",
        "accountCreateTime": "2019-08-25T21:00:44.6295625Z",
        "emailConfirmed": true
      },
      "sendTime": "2019-08-25T21:00:44.6297567Z",
      "content": "an example string.",
      "read": 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 Authorize Send message

Request path:

https://staging.server.kahla.app/Conversation/SendMessageCopy

Request content type:

application/x-www-form-urlencoded

Form content example:

Id=0&Content=yourContent&At[0]=yourAt&At[1]=yourAt&At[2]=yourAt 

Request form:

Name	Required	Type
Id	Required	Number
Content	Required	Text
At	Not required	Text Collection

Possible Response:

{
  "code": -1,
  "message": "Some error."
}

Possible Response:

{
  "items": [
    "Some item is invalid!"
  ],
  "code": -10,
  "message": "Your input contains several errors!"
}

---

GET Authorize Conversation detail

Request path:

https://staging.server.kahla.app/Conversation/ConversationDetailCopyTry

Request example:

https://staging.server.kahla.app/Conversation/ConversationDetail?id=0

Request arguments:

Name	Required	Type
id	Required	Number

Possible Response:

{
  "value": {
    "requesterId": "an example string.",
    "requestUser": {
      "makeEmailPublic": true,
      "themeId": 0,
      "email": "an example string.",
      "enableEmailNotification": true,
      "id": "an example string.",
      "bio": "an example string.",
      "nickName": "an example string.",
      "sex": "an example string.",
      "headImgFileKey": 0,
      "iconFilePath": "an example string.",
      "preferedLanguage": "an example string.",
      "accountCreateTime": "2019-08-25T21:00:44.6401914Z",
      "emailConfirmed": true
    },
    "targetId": "an example string.",
    "targetUser": {
      "makeEmailPublic": true,
      "themeId": 0,
      "email": "an example string.",
      "enableEmailNotification": true,
      "id": "an example string.",
      "bio": "an example string.",
      "nickName": "an example string.",
      "sex": "an example string.",
      "headImgFileKey": 0,
      "iconFilePath": "an example string.",
      "preferedLanguage": "an example string.",
      "accountCreateTime": "2019-08-25T21:00:44.6412613Z",
      "emailConfirmed": true
    },
    "anotherUserId": "an example string.",
    "id": 0,
    "discriminator": "an example string.",
    "aesKey": "an example string.",
    "maxLiveSeconds": 0,
    "conversationCreateTime": "2019-08-25T21:00:44.6415709Z",
    "displayName": "an example string.",
    "displayImagePath": "an example string."
  },
  "code": 0,
  "message": "an example string."
}

Possible Response:

{
  "value": {
    "users": [
      {
        "id": 0,
        "joinTime": "2019-08-25T21:00:44.666794Z",
        "muted": true,
        "userId": "an example string.",
        "user": {
          "makeEmailPublic": true,
          "themeId": 0,
          "email": "an example string.",
          "enableEmailNotification": true,
          "id": "an example string.",
          "bio": "an example string.",
          "nickName": "an example string.",
          "sex": "an example string.",
          "headImgFileKey": 0,
          "iconFilePath": "an example string.",
          "preferedLanguage": "an example string.",
          "accountCreateTime": "2019-08-25T21:00:44.6675141Z",
          "emailConfirmed": true
        },
        "groupId": 0,
        "readTimeStamp": "2019-08-25T21:00:44.6676547Z"
      }
    ],
    "groupImagePath": "an example string.",
    "groupName": "an example string.",
    "hasPassword": false,
    "ownerId": "an example string.",
    "id": 0,
    "discriminator": "an example string.",
    "aesKey": "an example string.",
    "maxLiveSeconds": 0,
    "conversationCreateTime": "2019-08-25T21:00:44.6678118Z",
    "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!"
}

---

POST Authorize Update message life time

Request path:

https://staging.server.kahla.app/Conversation/UpdateMessageLifeTimeCopy

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!"
}