API Documents

1. Server: 

API URL:

– production: https://app.home3ds.com/api/partner

– sandbox: https://test.home3ds.com/api/partner

Api key test: please contact us via: [email protected]

1. Product SKUs: 

SKUProductDescription
2D-FLOOR-PLAN2D floor plan
3D-FLOOR-PLAN
VIRTUAL-STAGING
VIRTUAL-STAGING-360
VIRTUAL-RENOVATION
VIRTUAL-RENOVATION-360
3D-WALKING-TOURS
IMAGE-ENHANCEMENT

2. Explain and example about api home3ds.

2.1. Create task: (task/create)

KeyTypeRequiredEmpty value / NoteNote
order_idstringyes
titlestringyes‘2D floor plan – Showcase modal’For 2D-FLOOR-PLAN: Title for option ‘2D floor plan – Showcase modal’ and ‘2D floor plan – Sketch’
order_datestringyesformat mysql “YYYY-MM-DD hh:mm:ss”
total_pricefloatno
contentstringyes-> see detail bellow
itemsarrayyes-> see detail bellow
Explain fields of items

– content: (html code) The content of the order, all data related to the order, e.g. options, image links, need to be formatted as html, to be displayed in the task description.

Product: 2D floor plan – Showcase modal
Add on: 2D full color floor plan 2D textured floor plan 2D site plan, 3D Floor Plan, 3D site plan
2D full color floor plan style: STYLE 2
2D textured floor plan style: STYLE 4
2D site plan style: STYLE 11
3D Floor Plan style: STYLE 02
Language:English
Address: 123 street
Project notes: Note

Convert it to HTML:

<div><strong>Product: </strong>: 2D Floor Plan</div>
<div><strong>Add on</strong>: 2D full color floor plan
2D textured floor plan
2D site plan, 3D Floor Plan, 3D site plan </div>
<div><strong>2D full color floor plan style</strong>: STYLE 2</div>
<div><strong>2D textured floor plan style</strong>: STYLE 4</div>
<div><strong>2D site plan style</strong>: STYLE 11</div>
<div><strong>3D Floor Plan style</strong>: STYLE 02</div>

<div><strong>Language</strong>:English</div>
<div><strong>Address</strong>: 123 street</div>
<div><strong>Project notes</strong>: Note</span></div>

– items: array of object bellow

KeyTypeRequiredEmpty value / Note
skustringyes
titlestringyes
dataobjectno{}
Explain fields of items

2.2. Account Integration: (integration/update)

KeyTypeRequiredEmpty value / Note
callback_urlstringyes
callback_authorization_keystringyes
Explain fields of items

Callback api url is the path to your api, when Hom3ds completes the order, we will call this api with data about the task ( such as order_id, image links.)

Callback auth key: This is the key that you provide to home3ds. The purpose is to authenticate when we call the api through your system.

2.3. Deliver callback: (receiver_order)

KeyTypeRequiredEmpty value / Note
order_idstringyes
skustringyes
linksarrayyesarray of link address
Explain fields of items

– links:

[
"https://home3ds.com/deliver_files/1.pdf",
"https://home3ds.com/deliver_files/2.pdf"
]