API

Common

Getting Started

User

Register New User
Login
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
Geo Discover Groups
Search vAtoms
Geo Discover vAtoms
Update vAtoms
Perform Action
Trash vAtom

User Activity

Get My Thread Messages
Get My Threads

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
Register Action Handler
Register Action
Update Action
Delete Action

Template Face

List Faces
Register Face
Update Face
Delete Face

Asset

Upload Assets
Get Assets
Delete Assets

Get My Threads

POST
https://api.blockv.io/v1/activity/mythreads

Overview

This request returns the list of event threads for the current user starting with the most recent one. Each thread can contain a number of events. The last event is included in the response for each thread.

Get My Threads Request

HTTP Headers

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

Payload Details

NameTypeDescription
cursorstringAllows you to filter out all threads more recent than the cursor (e.g. for paging). If omitted, the most recent threads are returned.
countintDefines the number of threads to be returned. If omitted, all matching threads are returned.

Sample Request

{ 
 "count": 2 
}

Get My Threads Response

Return & Error Codes

ErrorTypeDescription
200httpEverything is OK
400httpInvalid request
401httpAuthorization token missing
403httpNot logged in

Payload Object

NameTypeDescription
cursorstringValue that can be used in the next request for paging.
threadsarrayList of event threads.

Thread Object

NameTypeDescription
namestringThread identifier.
when_modifiedintTimestamp of the last modification of thread.
last_messageobjectLast event in the thread.
last_message_user_infoobjectThe other user involved in the last event in the thread.

User Info Object

NameTypeDescription
namestringThe name of the other user (if any).
avatar_uristringURI of the other user's avatar (if exists).

Sample Response

{
    "payload": {
        "cursor": "1.5282059138507648e+18",
        "threads": [
            {
                "name": "76e0d5ba-b97d-43d0-87b2-72f15f8a0ab3:",
                "when_modified": 1528369952906469632,
                "last_message": {
                    "msg_id": 1528369952906469706,
                    "user_id": "76e0d5ba-b97d-43d0-87b2-72f15f8a0ab3",
                    "vatoms": [
                        "13895c64-c805-4722-9002-c67307f94cab"
                    ],
                    "templ_vars": [
                        "vatomic.prototyping::3D-Object::Key"
                    ],
                    "msg": "You dropped a <b>Secret Key</b> vAtom onto the map.",
                    "action_name": "Drop",
                    "when_created": "2018-06-07T11:12:32Z",
                    "triggered_by": "",
                    "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
                },
                "last_message_user_info": {
                    "name": "",
                    "avatar_uri": ""
                }
            },
            {
                "name": "76e0d5ba-b97d-43d0-87b2-72f15f8a0ab3:715e0e66-3b18-4719-a927-3e06221ef95b",
                "when_modified": 1528205913850764800,
                "last_message": {
                    "msg_id": 1528205913850764839,
                    "user_id": "76e0d5ba-b97d-43d0-87b2-72f15f8a0ab3",
                    "vatoms": [
                        "024d5819-ee39-43d1-80b7-d68d711cf537"
                    ],
                    "templ_vars": [
                        "vatomic.prototyping::v1::vAtom::MSFolder1::Var1"
                    ],
                    "msg": "<b>vAtomic Demo</b> sent you a <b>Hello my published vAtom</b> vAtom.",
                    "action_name": "Transfer",
                    "when_created": "2018-06-05T13:38:33Z",
                    "triggered_by": "715e0e66-3b18-4719-a927-3e06221ef95b",
                    "generic": [
                        {
                            "name": "ActivatedImage",
                            "resourceType": "ResourceTypes::Image::JPEG",
                            "value": {
                                "resourceValueType": "ResourceValueType::URI",
                                "value": "http://philgons.com/wp-content/uploads/file-folder.jpg"
                            }
                        }
                    ],
                    "geo_pos": [
                        17.0333,
                        51.1
                    ],
                    "to_data_lake": false,
                    "no_message": false
                },
                "last_message_user_info": {
                    "name": "vAtomic Demo",
                    "avatar_uri": "https://cdndev.blockv.net/blockv/avatars/715e0e66-3b18-4719-a927-3e06221ef95b.1477297291330222019"
                }
            }
        ]
    }
}
©2018 BLOCKv
Info