1. Aiursoft Wiki Center
  2. Kahla
  3. Conversation

Conversation

Catalog

GET All

Request path:

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

Request example:

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

Try

Possible Response:

{
  "items": [
    {
      "displayName": "an example string.",
      "displayImagePath": "an example string.",
      "latestMessage": {
        "id": "bbefb972-6fa7-4216-a7b3-dd6a420cdf34",
        "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-01-24T09:45:43.8695488Z",
          "emailConfirmed": true
        },
        "sendTime": "2022-01-24T09:45:43.8696763Z",
        "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://staging.server.kahla.app/Conversation/GetMessage

Request example:

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

Try

Request arguments:

Name Required Type
id Required Number
take Not required Number
skipFrom Not required Text

Possible Response:

{
  "items": [
    {
      "id": "153d3211-0196-4eca-a851-5e08f701fac3",
      "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-01-24T09:45:43.8719798Z",
        "emailConfirmed": true
      },
      "sendTime": "2022-01-24T09:45:43.8721046Z",
      "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://staging.server.kahla.app/Conversation/SendMessage

Request example:

https://staging.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": "5297a715-5e7b-495b-b262-628d257bd430",
    "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-01-24T09:45:43.8816265Z",
      "emailConfirmed": true
    },
    "sendTime": "2022-01-24T09:45:43.8817349Z",
    "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://staging.server.kahla.app/Conversation/ConversationDetail

Request example:

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

Try

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-01-24T09:45:43.8927017Z",
      "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-01-24T09:45:43.9000442Z",
      "emailConfirmed": true
    },
    "anotherUserId": "an example string.",
    "id": 0,
    "discriminator": "an example string.",
    "aesKey": "an example string.",
    "maxLiveSeconds": 0,
    "conversationCreateTime": "2022-01-24T09:45:43.9002022Z",
    "displayName": "an example string.",
    "displayImagePath": "an example string."
  },
  "code": 0,
  "message": "an example string."
}

Possible Response:

{
  "value": {
    "users": [
      {
        "id": 0,
        "joinTime": "2022-01-24T09:45:43.9022578Z",
        "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-01-24T09:45:43.9034406Z",
          "emailConfirmed": true
        },
        "groupId": 0,
        "readTimeStamp": "2022-01-24T09:45:43.9035536Z"
      }
    ],
    "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-01-24T09:45:43.9037105Z",
    "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://staging.server.kahla.app/Conversation/FileHistory

Request example:

https://staging.server.kahla.app/Conversation/FileHistory?id=0&skipDates=0

Try

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-01-24T09:45:43.9101536Z"
    }
  ],
  "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://staging.server.kahla.app/Conversation/UpdateMessageLifeTime

Request example:

https://staging.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!"
}
View wiki in JSON