Get machine SOC value (VPP)
<p><strong>A brief description:</strong> </p>
<p>-Get machine SOC value interface (only supports MIN SPA SPH models)</p>
<p><strong>Request URL:</strong>
-<code>http(s)://test.growatt.com/v1/device/vpp/getSocData</code></p>
<p><strong>How to request:</strong>
-post</p>
<p><strong>Parameter:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Parameter name</th>
<th style="text-align: left;">Is it required</th>
<th style="text-align: left;">Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">vppSn</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">String</td>
<td>Device SN</td>
</tr>
</tbody>
</table>
<p><strong>Return example</strong></p>
<pre><code>{
"sn": "MIXECN6000",
"error_code": 0,
"dataLogSn": "JPC5A11700",
"soc": 65,
"error_msg": ""
}</code></pre>
<p><strong>Return parameter description</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Parameter name</th>
<th style="text-align: left;">Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">String</td>
<td>The returned result is shown in the following remarks</td>
</tr>
<tr>
<td style="text-align: left;">sn</td>
<td style="text-align: left;">string</td>
<td>Device serial number</td>
</tr>
<tr>
<td style="text-align: left;">dataLogSn</td>
<td style="text-align: left;">string</td>
<td>Device collector serial number</td>
</tr>
<tr>
<td style="text-align: left;">soc</td>
<td style="text-align: left;">int</td>
<td>SOC value</td>
</tr>
<tr>
<td style="text-align: left;">error_code</td>
<td style="text-align: left;">string</td>
<td>0: normal return, 10001: read failure, 10002: device does not exist, 10003: device serial number is empty</td>
</tr>
<tr>
<td style="text-align: left;">error_msg</td>
<td style="text-align: left;">string</td>
<td>Error message prompt</td>
</tr>
</tbody>
</table>
<p><strong>Remarks</strong>
-The frequency of acquisition is once every 10 seconds</p>