diaspora_federation/docs/_entities/conversation.md
Benjamin Neff 5e81760f30
Remove participants limit for conversations
The limit was added in 2012 to prevent spam, but since the participants
need to be a mutual contact with the author nowadays, I don't think it's
a spam problem anymore.

I also added a validation for the minimum count of the participants,
because a conversion without participants doesn't make much sense.
2018-01-18 02:50:04 +01:00

2.2 KiB

title
Conversation

This entity represents a private conversation between persons.

Properties

Property Type (Length) Description
author [diaspora* ID][diaspora-id] The diaspora* ID of the author of the conversation.
guid [GUID][guid] The GUID of the conversation.
subject [String][string] (255) The subject of the conversation.
created_at [Timestamp][timestamp] The create timestamp of the conversation.
participants [diaspora* ID][diaspora-id]s diaspora* IDs of all participants of this conversation, including the author, seperated by ;.
message [Message][message] The first Message in the conversation, needs to be the same author.

Example

<conversation>
  <author>alice@example.org</author>
  <guid>9b1376a029eb013487753131731751e9</guid>
  <subject>this is a very informative subject</subject>
  <created_at>2016-07-11T23:17:48Z</created_at>
  <participants>alice@example.org;bob@example.com</participants>
  <message>
    <guid>5cc5692029eb013487753131731751e9</guid>
    <text>this is a very informative text</text>
    <created_at>2016-07-11T23:17:48Z</created_at>
    <author>alice@example.org</author>
    <conversation_guid>9b1376a029eb013487753131731751e9</conversation_guid>
  </message>
</conversation>

[diaspora-id]: {{ site.baseurl }}/federation/types.html#diaspora-id [guid]: {{ site.baseurl }}/federation/types.html#guid [string]: {{ site.baseurl }}/federation/types.html#string [timestamp]: {{ site.baseurl }}/federation/types.html#timestamp [message]: {{ site.baseurl }}/entities/message.html