Solargis TMY API integration setup

Prev Next

In this guide, we will explain how to set up the Solargis TMY API integration.

To setup the integration, we recommend using our FREE dedicated API integration setup endpoints defined in this guide to perform testing calls. This will help you set up your API without spending any subscription credits.

Tip: If your integration has already been set, you can learn how to obtain the requestId for your TMY data here.

There is a separate integration testing request for every subscription (TMY Basic and TMY Pro):

  • The URL endpoint is identical for both requests.

  • They differ in API token values and body parameters. Both values are listed in the respective tables below.

Integration setup endpoint parameters

Use the parameters below to configure your request. Select the setup corresponding to your subscription type to prevent future errors. The endpoints are free to access and do not incur any charges to your account.

Important: Do not modify any of the request body parameters. The endpoint will only accept the parameters exactly as listed in the table; any changes will cause the call to fail.

TMY Basic integration setup

Get your requestId

Request type:

POST

URL:

https://api.solargis.com/tmy-integration/data-request

Authorization:

Bearer “MDAxLnNnMnwxMjMzNC5FSjl0Qlo0aHJJLjBmRWFTWnJsRFo5N1hOd2QwYjVEV2c1WEJDRTRpcFhvR3JZcFZ6emVhQ0k9”

Body parameters:

{
    "latitude": 48.61259,
    "longitude": 20.827079,
    "timeStep": "PT60M",
    "tmyScenario": "P50",
    "siteName": "Basic example Site",
    "fileLabel": "basic_01",
    "outputFormats": ["SOLARGIS_CSV", "SOLARGIS_JSON", "SAM", "HELIOSCOPE"]
}

Get your TMY Basic data using the requestId

Request type:

GET

URL:

https://api.solargis.com/tmy-integration/data-request/{requestId}

Authorization:

Bearer “MDAxLnNnMnwxMjMzNC5FSjl0Qlo0aHJJLjBmRWFTWnJsRFo5N1hOd2QwYjVEV2c1WEJDRTRpcFhvR3JZcFZ6emVhQ0k9”

Body parameters: N/A

TMY Pro integration setup

Get your requestId

Request type:

POST

URL:

https://api.solargis.com/tmy-integration/data-request

Authorization:

Bearer “MDAxLnNnMnwxMjMzNC5TT3dxR0xrMnJZLjVZOU1VVTFHY1h0bmVrV0llT2lvalJyNEhjcnhWNDlDMExKRU4xQ3E1UUU9”

Body parameters:

{
     "latitude": 48.61259,
     "longitude": 20.827079,
     "timeStep": "PT60M",
     "tmyScenario": "P50",
     "siteName": "Pro example Site",
     "fileLabel": "pro_01",
     "outputFormats": ["SOLARGIS_CSV", "SOLARGIS_JSON", "SAM", "HELIOSCOPE"]
}

Get your TMY Pro data using the requestId

Request type:

GET

URL:

https://api.solargis.com/tmy-integration/data-request/{requestId}

Authorization:

Bearer “MDAxLnNnMnwxMjMzNC5TT3dxR0xrMnJZLjVZOU1VVTFHY1h0bmVrV0llT2lvalJyNEhjcnhWNDlDMExKRU4xQ3E1UUU9”

Body parameters: N/A