📊Data

Learn how to post data to the project.

Get a global data entry

GET https://api.echo3D.com/get?key=<API_KEY>&data=<DATA>

This query allows you to get global data entries.

Query Parameters

Name	Type	Description
key	string	Your API key.
data	string	A data key, e.g. scale.
secKey	string	Your Secret key. Only if enabled through the Security page.

200

<VALUE>

400

Invalid request! No data value found in request.

404

Data not found

Post a global data entry

POST https://api.echo3D.com/post?key=<API_KEY>&data=<DATA>&value=<VALUE>

This query allows you to add a global data entry.

Query Parameters

Name	Type	Description
key	string	The API key.
data	string	A data key, e.g. scale.
value	string	A data value, e.g. 2.
secKey	string	Your Secret key. Only if enabled through the Security page.

200

<VALUE>

400

Invalid request! No data value found in request.

Delete global data entry

POST https://api.echo3d.com/remove?key=<API_KEY>&data=<DATA>&email=<EMAIL>

This query allows you to remove a global data entry.

Request Body

Name	Type	Description
key*	String	Your API key
data*	String	A data key, e.g. scale.
email*	String	User email
secKey	String	Your Secret key. Only if enabled through the Security page

Get metadata of an entry

GET https://api.echo3D.com/get?key=<API_KEY>&entry=<ENTRY>&data=<DATA>

The query allows you to get metadata of a specific entry. You can either query for a specific data key or for all the data associated with the entry.

Query Parameters

Name	Type	Description
key	string	Your API key.
entry	string	A specific entry ID.
data	string	A data key, e.g. scale.
secKey	string	Your Secret key. Only if enabled through the Security page.

200

{
    "<KEY_1>": "<VALUE_1>",
    "<KEY_2>": "<VALUE_2>",
    "<KEY_3>": "<VALUE_3>",
    ...
}

302

<VALUE>

400

Invalid request! No data value found in request.

404

Data not found

Post metadata to an entry

POST https://api.echo3D.com/post?key=<API_KEY>&entry=<ENTRY>&data=<DATA>&value=<VALUE>

This query allows you to add metadata to a specific entry.

Query Parameters

Name	Type	Description
key	string	Your API key
entry	string	A specific entry ID.
data	string	A data key, e.g. scale.
value	string	A data value, e.g. 2.
secKey	string	Your Secret key. Only if enabled through the Security page.

200

Additional data <DATA,VALUE> updated in entry <ENTRY>.

400

Invalid request! No data value found in request.

Delete metadata from an entry

POST https://api.echo3d.com/remove?key=<API_KEY>&entry=<ENTRY>&data=<DATA>&email=<EMAIL>

This query allows you to remove metadata to a specific entry.

Request Body

Name	Type	Description
key*	String	Your API key
entry*	String	A specific entry ID.
data*	String	A data key, e.g. scale.
email*	String	User email
secKey	String	Your Secret key. Only if enabled through the Security page

200: OK

Additional data key <data> removed in entry <entry>

400: Bad Request

Invalid request! 

Post metadata to a few entries with the same data name at the same time

POST https://api.echo3d.com/batchpost?key=<API_KEY>&entries=<ENTRY_IDs>&data=<DATA>&value<ENTRY_VALUES>

You can set a few entries with the same data name together, even if they have a different value

Request Body

Name	Type	Description
key*	String	Your API key
entries*	String	A list of entries to update, separated by a comma (',')
data*	String	A data key, e.g. scale.
value*	String	A list of data values, corresponding with the entry IDs, separated by a comma (','). e.g. 2,5,1. Your number of values must be the same as the number of entries you wish to update.
secKey	String	Your Secret key. Only if enabled through the Security page

Query the number of clicks received by custom buttons for WebAR

GET https://api.echo3D.com/query?key=<API_KEY>&webARButtonClick=true

Request Body

Name	Type	Description
key*	String	Your API key
webARButtonClick*	String	true, to get the number of clicks
secKey	String	Your Secret key. Only if enabled through the Security page.

200: OK

{
  "topLeftClickCounter": 0,
  "bottomRightClickCounter": 0,
  "centerClickCounter": 0,
  "rightClickCounter": 0,
  "topRightClickCounter": 0,
  "bottomClickCounter": 0,
  "bottomLeftClickCounter": 0,
  "leftClickCounter": 0,
  "topClickCounter": 0
}

400: Bad Request

Key <API_KEY> not found!