This guide shows how to make an API request in your sandbox tenant. Before moving to production, you will need to switch to our production app authorization workflow.

Key Terms

Tenant - An instance of Aurora, associated with a customer. Each tenant can have multiple users working on it at the same time.

Project - A container for all the information for a given site and system designs. In most solar workflows, there is one project per sale, which could have multiple designs inside of it.

Design- A solar design for a project. Includes site modeling, system design, performance simulations, and more.

Sync API- The Aurora API available to tenants. See the full documentation at docs.aurorasolar.com

Sandbox - A production-equivalent test environment with no customer data. This environment is designed for you to learn about Aurora and implement your integration. Once your integration is running in sandbox, Aurora can enable your integration in production and start receiving real customer data.

• The URL to your sandbox UI is https://v2-sandbox.aurorasolar.com.
• The base API URL (hostname) for your sandbox is https://api-sandbox.aurorasolar.com.

Make a Test API Request

Aurora will provide you with credentials to access a test tenant in the Aurora Sandbox. This will allow you to experience Aurora from the customer’s side, and learn what resources you’ll have access to for your integration.

1. Log in at sandbox.aurorasolar.com. Aurora will send you an email to set up your credentials.

2. Create a bearer token to access the Sync API: https://help.aurorasolar.com/hc/en-us/articles/11646854001299-API-Tokens.

   1. Note: Standard bearer tokens only provides access for your test tenant, and will not work as production authentication.

3. Create a project in Aurora: https://help.aurorasolar.com/hc/en-us/articles/12290229701523-Creating-a-Project-in-New-Aurora

4. Use the List Project API to view your project:

   JSON

   curl --request GET \
        --url https://api-sandbox.aurorasolar.com/tenants/tenant_id/projects \
        --header 'accept: application/json'
   		 --header 'authorization: Bearer {YOUR_BEARER_TOKEN_HERE}'
   

Related Documents

To learn more about how tenants use the Aurora app, visit the Aurora Help Center: https://help.aurorasolar.com/hc/en-us

To set up your application’s production authorization, see Authorizing your app.