Documentation

API: Single Product Upload

Add or update a single product in your Dezyn3D inventory.

Endpoint

POST/v1/single_upload

Headers

  • X-Dezyn-Access-Token: YOUR_ACCESS_TOKEN — Your unique access token. You can generate one from your API Integration page.
  • Content-Type: application/json

Request Body

The body should be a single JSON object representing your product. The title, product_id, and front_image_url fields are required. Other image URLs are optional but recommended.

Responses

The API will return a JSON object indicating the status of the request.

Success

HTTP 200 OK { "message": "Success message appears here" }

Failure

HTTP 400/500 Bad Request/Server Error { "error": "A description of what went wrong." }

Example (Python)


import requests
import json

API_BASE_URL = "https://api.dezyn.app"
# Replace with your actual access token from your Dezyn3D account
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN" 
url = f"{API_BASE_URL}/v1/single_upload"

headers = {
    "X-Dezyn-Access-Token": ACCESS_TOKEN,
    "Content-Type": "application/json",
    "Accept": "application/json"
}

# This is a single product object
payload = {
    "title": "Classic Leather Sneaker",
    "product_id": "SH-CL-001",
    "front_image_url": "https://example.com/sneaker_front (required)",
    "back_image_url": "https://example.com/sneaker_back (optional)",
    "left_image_url": "https://example.com/sneaker_left (optional)",
    "right_image_url": "https://example.com/sneaker_right (optional)"
}

response = requests.post(url, headers=headers, json=payload)

print(response.status_code)
print(response.json())