SolarNetwork API Explorer

This page allows you to explore the SolarNetwork web API. Fill in your SolarNetwork authorization token and server details on the left, then use the API templates to fill in an API URL to call. Replace any template parameters (for example, replace {nodeId} with your node's ID). Then click the Execute button to submit the query and display the results at the bottom. The source code for this app is available on GitHub.

Auth Support

This shows the the computed HTTP Authorization header:


							

The following sections detail the steps taken to generate the Authorization header.

Canonical request message

This shows the canonical request message that is hashed and included in the authorization message:


							
Signing message

This shows the signing message that is hashed to form the authorization signature value:


							
Signing key

This shows the hex-encoded signing key used to sign the message, derived from the token secret using a signing date value of YYYYMMDD:


						

This shows the computed HTTP message signature fields. Send both with the request:


							

The following sections detail the steps taken to generate them.

Covered components

These are the message components the signature covers. SolarNetwork requires the request method, authority and path, plus the query when there is one, the content type and a Content-Digest when there is request content, and every X-SN-* header:


							
Signature base

This shows the signature base, the exact string that is signed. The last line is the @signature-params value, which is repeated in the Signature-Input field so the server can rebuild this string:


							
Signing key

This shows the hex-encoded signing key, identified by the keyid signature parameter token:


							

Curl command
— check this to only generate the curl command, without actually making the request in the browser.

This shows a curl command to make the same HTTP request: