🔼 Upload

Learn how to upload assets with a query.

post
Upload content entry

https://console.echoAR.xyz/upload
This endpoint allows you to upload a new 3D content entry.
Request
Response
Request
Form Data Parameters
key
required
string
Your API key.
target_type
required
object
A type of target. Options: IMAGE_TAGET, GEOLOCATION_TARGET, or BRICK_TARGET
hologram_type
required
object
A type of hologram: Options: MODEL_HOLOGRAM or VIDEO_HOLOGRAM
Response
200: OK
Cake successfully retrieved.
{
"id": "3b020b06-9ba1-42f1-87e7-eec3b33617c0",
"target": {
"id": "147fdbe5-2724-44ed-b6ec-31ae8bbbe50a",
"type": "BRICK_TARGET",
"holograms": [
"bca5895d-29c6-4e74-b843-a014bdb0962c"
]
},
"hologram": {
"filename": "Skyscraper.obj",
"storageID": "d686a655-e800-430d-bfd2-e38cdfb0c9e9",
"textureFilenames": [
"Skyscraper_BaseColor.png"
],
"textureStorageIDs": [
"f9b43711-cf79-44e5-90c5-ac781c8d9288"
],
"materialFilename": "Skyscraper.mtl",
"materialStorageID": "891d0b32-4f4b-4f7d-a2e2-d5922611928d",
"id": "bca5895d-29c6-4e74-b843-a014bdb0962c",
"type": "MODEL_HOLOGRAM",
"targetID": "147fdbe5-2724-44ed-b6ec-31ae8bbbe50a"
},
"sdks": [
true,
true,
false,
true,
false,
false,
false,
true,
true
],
"additionalData": {
"accessHistory": "[\"1586222284478\"]",
"createdAt": "1586222284478",
"glbHologramStorageFilename": "Skyscraper.glb",
"glbHologramStorageID": "d686a655-e800-430d-bfd2-e38cdfb0c9e9.glb",
"lastAccessed": "1586222284478",
"qrARjsMarkerStorageFilename": "marker_qr_arjs_blue-water-4646.png",
"qrARjsMarkerStorageID": "5d8dc812-12ba-43a6-b00d-6f199bde16ce",
"qrARjsStorageFilename": "qr_arjs_blue-water-4646.png",
"qrARjsStorageID": "f32c0d9f-15b9-45b6-9371-630384ad588f",
"qrARjsTargetStorageFilename": "qr_arjs_blue-water-4646.patt",
"qrARjsTargetStorageID": "18e93bb9-a535-4764-94a4-6d6e5a16e260",
"qrWebXRStorageFilename": "qr_webxr_blue-water-4646.png",
"qrWebXRStorageID": "fbd798e7-fc13-43cd-bc9d-cfa0df1aabb6",
"source": "Skyscraper by Poly by Google, CC-BY, https://poly.google.com/view/dIsZyy2FUY-",
"vuforiaHologramStorageFilename": "Skyscraper.h",
"vuforiaHologramStorageID": "7068cd74-6c9f-4106-9326-585c56fa4475"
}
}
400: Bad Request
Could not find a cake matching this query.
Key '<API_KEY>' not found!

Target Type

Target types can be one of the following:

IMAGE_TAGET

If you choose to use an image as your AR target, you must also add to your request one of the following:

  • url_image: A URL to the image you want to use as a target.

  • file_image: The image file you want to use as a target. The file will be uploaded as Part.

GEOLOCATION_TARGET

A location target must be associated with a location. You must either send an address or send a location coordinates (longitude and latitude):

  • text_geolocation: Address for the location.

  • longitude and latitude: Longitude and latitude coordinates

BRICK_TARGET

A surface target needs not additional arguments.

Hologram Type

Hologram types can be one of the following:

VIDEO_HOLOGRAM

Using the video hologram option, you can upload a video file, audio file, or animated image as your 3D asset. Your request must include one of the following:

  • url_video: A URL to the video/ audio/ image you want to use as your AR object.

  • file_video: The video/ audio/ image file you want to use as your AR object. The file will be uploaded as Part.

MODEL_HOLOGRAM

Using the model hologram you can upload 3D models to your project. A Model hologram request must also include type, which must be one of the following values:

  • upload: New model file upload. Expected a file part from local storage.

  • search: Getting a 3D model from third-party 3D search engines. If the search option is chosen, a source must be set as well :