Common

Getting Started

User

Logout

Refresh Access Token

Get User Profile

Update Profile

Upload Avatar

Delete User

Reset Password

Reset Password by ID

User Token

List User Tokens

Add User Token

Update Default User Token

Delete User Token

Verify User Token

Reset Verification Code

User vAtom

Get vAtom

Get vAtoms by Ids

Get vAtom Inventory

Search vAtoms

Geo Discover Groups

Geo Discover vAtoms

Update vAtoms

Perform Action

Trash vAtom

User Activity

Get My Threads

Get My Thread Messages

Template

List Templates

Get Template

Create Template

Update Template

Delete Template

Template Variation

List Variations

Get Variation

Create Variation

Update Variation

Delete Variation

vAtom

Emit vAtom

Template Action

List Actions

Get Action

Update Action

Delete Action

Template Face

List Faces

Update Face

Delete Face

Asset

Upload Assets

Get Assets

Delete Assets

Get My Thread Messages

POST

https://api.blockv.io/v1/activity/mythreadmessages

Overview

This request returns event messages in a thread belonging to the current user starting with the most recent one. Each thread can contain a number of event messages.

Get My Thread Messages Request

HTTP Headers

Content-Type: application/json
App-Id: {app_id}

Payload Details

Name	Type	Description
`name` *	string	Thread identifier.
`cursor`	string	Allows you to filter out all messages more recent than the `cursor` (e.g. for paging). If omitted, the most recent messages are returned.
`count`	int	Defines the maximum number of messages to be returned. If omitted, all matching messages are returned.

Sample Request

{ 
 "name": "76e0d5ba-b97d-43d0-87b2-72f15f8a0ab3:824ae003-ac9d-4159-9621-a3221360cc38",
 "count": 2 
}

Get My Thread Messages Response

Return & Error Codes

Error	Type	Description
`200`	http	Everything is OK
`400`	http	Invalid request
`401`	http	Authorization token missing
`403`	http	Unauthorized or missing thread `name`

Payload Object

Name	Type	Description
`cursor`	string	Value that can be used in the next request for paging.
`messages`	array	List of event messages.

Event Object

Name	Type	Description
`message`	object	The event message.
`when_modified`	int	Timestamp of the last modification.

Message Object

Name	Type	Description
`msg_id`	int	Message identifier.
`user_id`	string	Identifier of the other user involved.
`vatoms`	array	List of identifiers of the vAtoms involved.
`templ_vars`	array	Template variation names for each of these vAtoms.
`msg`	string	Message text.
`action_name`	string	Name of the action that caused the event.
`when_created`	string	Date and time when the event happened.
`triggered_by`	string	Identifier of the user who triggered the action.
`generic`	array	List of resources.
`geo_pos`	array	Geo position (longitude, then latitude) of the current user at the time of the event.

Sample Response

{
    "payload": {
        "cursor": "1.523280543853133e+18",
        "messages": [
            {
                "message": {
                    "msg_id": 1523280568449439009,
                    "user_id": "76e0d5ba-b97d-43d0-87b2-72f15f8a0ab3",
                    "vatoms": [
                        "ab8aa7a5-7056-4fd0-912e-976971fd1695"
                    ],
                    "templ_vars": [
                        "vatomic.prototyping::3D-Object::Key"
                    ],
                    "msg": "You sent <b> </b> a <b>Secret Key</b> vAtom.",
                    "action_name": "Transfer",
                    "when_created": "2018-04-09T13:29:28Z",
                    "triggered_by": "824ae003-ac9d-4159-9621-a3221360cc38",
                    "generic": [
                        {
                            "name": "ActivatedImage",
                            "resourceType": "ResourceTypes::Image::JPEG",
                            "value": {
                                "resourceValueType": "ResourceValueType::URI",
                                "value": "https://cdndev.blockv.net/vatomic.prototyping/vatomic.prototyping::v1::vAtom::3D-Object/key_card.jpg"
                            }
                        }
                    ],
                    "geo_pos": [
                        17.0333,
                        51.1
                    ],
                    "to_data_lake": true,
                    "no_message": false
                },
                "when_modified": 1523280568449438976
            },
            {
                "message": {
                    "msg_id": 1523280543853132973,
                    "user_id": "76e0d5ba-b97d-43d0-87b2-72f15f8a0ab3",
                    "vatoms": [
                        "670eedc1-f83c-4ffe-8e0f-9471f784be9f"
                    ],
                    "templ_vars": [
                        "vatomic.prototyping::CouponCard::Harvelles"
                    ],
                    "msg": "<b> </b> sent you a <b>Free Drink</b> vAtom.",
                    "action_name": "Transfer",
                    "when_created": "2018-04-09T13:29:03Z",
                    "triggered_by": "824ae003-ac9d-4159-9621-a3221360cc38",
                    "generic": [
                        {
                            "name": "ActivatedImage",
                            "resourceType": "ResourceTypes::Image::PNG",
                            "value": {
                                "resourceValueType": "ResourceValueType::URI",
                                "value": "https://cdndev.blockv.net/vatomic.prototyping/vatomic.prototyping::v1::vAtom::CouponCard/harvelles_icon.png"
                            }
                        }
                    ],
                    "geo_pos": [
                        17.0333,
                        51.1
                    ],
                    "to_data_lake": false,
                    "no_message": false
                },
                "when_modified": 1523280543853133056
            }
        ]
    }
}

Info