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
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
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 vAtom Inventory

POST
https://api.blockv.io/v1/user/vatom/inventory

Overview

This request returns the current user inventory of vAtoms. The response includes the vAtoms as well as the configured Faces and Actions.

Get vAtom Inventory Request

HTTP Headers

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

Payload Details

NameTypeDescription
parent_idstringAllows you to specify a vAtom-ID of a folder vAtom to return the folder content. A dot . can be used to return non-folder vAtoms.
limitintDefines the number of vAtoms per response page (up to 100). If omitted, it returns the max. number.
pageintThe number of the page for which the vAtoms are returned. If omitted, the first page is returned.

Sample Request

{
    "parent_id": ".",
    "limit": 2,
    "page": 0
}

Get vAtoms by IDs Response

Return & Error Codes

ErrorTypeDescription
200httpEverything is OK
403httpNot Authorized

payload Object

NameTypeDescription
[ vatoms ]arrayAn array of vAtom objects.
facesarrayAn array of Faces that are registered for the requested vAtoms.
actionsarrayAn array of Actions that are registered for the requested vAtoms.

Sample Response

{
    "payload": {
        "vatoms": [
            {
                "id": "4e6e53e8-06d3-4b6a-8a7a-bb26626e1a2a",
                "in_sync": false,
                "is_syncing": false,
                "private": {},
                "unpublished": false,
                "vAtom::vAtomType": {
                    "acquirable": true,
                    "author": "001d0933-88e6-4e17-b147-0f672dc016d1",
                    "category": "",
                    "cloned_from": "",
                    "cloning_score": 0,
                    "commerce": {
                        "pricing": {
                            "pricingType": "Fixed",
                            "value": {
                                "currency": "",
                                "price": "0",
                                "valid_from": "*",
                                "valid_through": "*",
                                "vat_included": false
                            }
                        }
                    },
                    "description": "",
                    "disabled": false,
                    "dropped": false,
                    "geo_pos": {
                        "$reql_type$": "GEOMETRY",
                        "coordinates": [
                            0,
                            0
                        ],
                        "type": "Point"
                    },
                    "in_contract": false,
                    "in_contract_with": "",
                    "notify_msg": "",
                    "num_direct_clones": 0,
                    "owner": "001d0933-88e6-4e17-b147-0f672dc016d1",
                    "parent_id": ".",
                    "publisher_fqdn": "publisher_fqdn",
                    "redeemable": true,
                    "resources": [
                        {
                            "name": "ActivatedImage",
                            "resourceType": "ResourceType::Image::PNG",
                            "value": {
                                "resourceValueType": "ResourceValueType::URI",
                                "value": "https://cdn.blockv.io/mypicture.png"
                            }
                        }
                    ],
                    "root_type": "vAtom::vAtomType",
                    "states": [
                        {
                            "name": "Activated",
                            "on_state_change": {
                                "reactor": ""
                            },
                            "value": {
                                "type": "boolean",
                                "value": "true"
                            }
                        }
                    ],
                    "tags": [],
                    "template": "publisher_fqdn::Template_Name::v1",
                    "template_variation": "publisher_fqdn::Template_Name::Variation",
                    "title": "My vAtom",
                    "tradeable": false,
                    "transferable": true,
                    "transferred_by": "",
                    "visibility": {
                        "type": "owner",
                        "value": "*"
                    }
                },
                "version": "v1::vAtomType",
                "when_created": "2018-01-01T00:00:00Z",
                "when_modified": "2018-01-01T00:00:00Z"
            }
        ],
        "actions": [
            {
                "name": "publisher_fqdn::Template_Name::v1::Action::Transfer",
                "meta": {
                    "created_by": "001d0933-88e6-4e17-b147-0f672dc016d1",
                    "when_created": "2018-01-01T00:00:00Z",
                    "modified_by": "",
                    "when_modified": "",
                    "data_type": "v1::ActionType",
                    "in_sync": true,
                    "when_synced": "",
                    "is_syncing": false
                },
                "properties": {
                    "name": "publisher_fqdn::Template_Name::v1::Action::Transfer",
                    "reactor": "blockv://v1/Transfer",
                    "wait": true,
                    "rollback": false,
                    "abort_on_pre_error": true,
                    "abort_on_post_error": false,
                    "abort_on_main_error": true,
                    "timeout": 10000,
                    "guest_user": true,
                    "state_impact": [],
                    "policy": {
                        "pre": [],
                        "rule": "",
                        "post": []
                    },
                    "params": {
                        "input": [],
                        "output": []
                    },
                    "config": {
                        "auto_create_landing_page": "http://viewer.blockv.io/#",
                        "auto_create_mode": "claim",
                        "auto_create_non_existing_recipient": true
                    },
                    "limit_per_user": 0,
                    "action_notification": {
                        "on": true,
                        "msg": "You received a vAtom",
                        "custom": {}
                    }
                }
            }
        ],
        "faces": [
            {
                "id": "00ad0f31-53c1-4b11-88fd-3fcb3f7e8f82",
                "template": "publisher_fqdn::Template_Name::v1",
                "meta": {
                    "created_by": "001d0933-88e6-4e17-b147-0f672dc016d1",
                    "when_created": "2018-01-01T00:00:00Z",
                    "modified_by": "",
                    "when_modified": "",
                    "data_type": "v1::FaceType",
                    "in_sync": false,
                    "when_synced": "",
                    "is_syncing": false
                },
                "properties": {
                    "display_url": "native://image",
                    "package_url": "native://image",
                    "constraints": {
                        "bluetooth_le": false,
                        "contact_list": false,
                        "gps": false,
                        "three_d": false,
                        "view_mode": "icon",
                        "platform": "generic",
                        "quality": "high"
                    },
                    "resources": [
                        "ActivatedImage"
                    ]
                }
            }
        ]
    }
}
©2020 BLOCKv
Info