Tutorials

Create a 3D roof model for testing

This tutorial shows how to instantly create a 3D roof model to test your integration.

How It Works


You will make an API call to the mock expert design service. The service is available to all Aurora tenants free of charge and produces instant 3D roof models for select project locations.

Getting Started


To complete this tutorial, you will need:

  • your Aurora tenant to be on the Custom or Business plan,
  • your Aurora tenant to use the current API version,
  • your Aurora bearer token,
  • your Aurora tenant_id.

You or any Administrator for your Aurora tenant can retrieve the token and tenant id from the API Settings page.

Step 1. Create a project in Aurora


Create a project for one of the following addresses using the Aurora application or API.

  • 901 Mears Ct, Stanford, CA 94305, USA
  • 634 Mirada Ave, Stanford, CA 94305, USA
  • 419 10th Ave, Belmar, NJ 07719, USA
  • 7126 Casita Dr, Magnolia, TX 77354, USA
//POST https://api-sandbox.aurorasolar.com/tenants/{tenant_id}/projects
{
 "project": {
   "address": "901 Mears Ct, Stanford, CA 94305, USA"
 }
}

//HTTP 200 Response
{
    "project": {
        "id": "733030f3-2573-43db-8906-a41e95662012",
        "external_provider_id": null,
        "created_from_lead_id": null,
        "name": null,
        "customer_salutation": null,
        "customer_first_name": null,
        "customer_last_name": null,
        "customer_address": null,
        "customer_email": null,
        "customer_phone": null,
        "address": "901 Mears Ct, Stanford, CA 94305, USA",
        "latitude": 37.4162953,
        "longitude": -122.1570644,
        "project_type": "residential",
        "owner_id": null,
        "status": null
    }
}

Step 2. Create a mock expert design service request


Create a design request using the project_id from step 1, setting auto_accept to true. The request will be instantly fulfilled by the mock expert design service. You can access the newly created design via the Aurora UI or API.

//POST [https://api-sandbox.aurorasolar.com/tenants/{tenant_id}/](https://api-sandbox.aurorasolar.com/v2/tenants/%7Btenant_id%7D/projects)design_requests
{
 "design_request": {
   "project_id": "733030f3-2573-43db-8906-a41e95662012",
   "auto_accept": true
 }
}

//HTTP 200 response
{
    "design_request": {
        "id": "e05a0ad0-ef50-4a2c-b1c1-6a227435b857",
        "project_id": "733030f3-2573-43db-8906-a41e95662012",
        "status": "submitted",
        "design_id": null,
        "address": "901 Mears Ct, Stanford, CA 94305, USA",
        "latitude": 37.4162953,
        "longitude": -122.1570644,
        "submitted_at": "2022-06-22T21:12:36.795Z",
        "completed_at": null,
        "reviewed_at": null,
        "image_src": "Google",
        "lidar_src": "Google Sunroof",
        "sla": 180,
        "designer_rejection_reason": null,
        "auto_accept": true,
        "auto_accepted": null,
        "designer_rejected_at": null
    }
}
3084

3D roof model complete with trees for 901 Mears Ct in Stanford, CA produced by the mock expert design service

Considerations


  • You have to neither use the Aurora expert design service nor integrate with it to take advantage of mock designs that Design Requests API produces.
  • Each address recognized by the mock expert design service produces a different type of roof.