ReadOfflineMsgs

From Second Life Wiki
Revision as of 05:02, 1 April 2022 by Monty Linden (talk | contribs) (Created page with "Category:Capabilities The ReadOfflineMsgs Capability performs a function similar to the RetrieveInstantMessages LLMessage. It retrieves offline Instant Messages and return...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The ReadOfflineMsgs Capability performs a function similar to the RetrieveInstantMessages LLMessage. It retrieves offline Instant Messages and returns them to the caller. Those IMs are returned directly in the response body rather than in individual messages. As a side-effect of the retrieval, certain offers, such as friendship, may become active and available to the caller.


Client Request GET ->
<empty>

; 200 Response <-
[
  [
    {
      asset_id:  UUID,
      binary_bucket:  Binary,
      dialog:  Integer,
      estate_id:  Integer,
      from_agent_id:  UUID,
      from_agent_name:  String,
      from_group:  Boolean,
      message:  String,
      message_time:  String,
      offline:  Integer,
      parent_estate_id:  Integer,
      position:  [ Real, Real, Real ],
      region_id:  UUID,
      timestamp:  Integer,
      to_agent_id:  UUID,
      transaction-id:  UUID
    },
    {
    },
    ...
    {
    }
  ]
]

An early form of the service had a response structure of:

{
  messages: [
    {
      <IM_0>
    },
    {
      <IM_1>
    },
    ...
    {
      <IM_n>
    }
  ]
]

but that should not be encountered anymore.