2.1 Add power station
<p><strong>A brief description:</strong> </p>
<ul>
<li>Add the interface of the power station</li>
</ul>
<p><strong>Request URL: </strong></p>
<ul>
<li><code>http(s)://test.growatt.com/v1/plant/add</code>
<strong>Request method: </strong></li>
<li>post</li>
</ul>
<p><strong>Parameters: </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;">c_user_id</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">int</td>
<td>User ID to which the power station belongs</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">string</td>
<td>power station name</td>
</tr>
<tr>
<td style="text-align: left;">peak_power</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">float</td>
<td>peak power (kWp)</td>
</tr>
<tr>
<td style="text-align: left;">latitude_f</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">string</td>
<td>Area [country list](<a href="https://www.showdoc.com.cn/dfsfdf/9187729846853701">https://www.showdoc.com.cn/dfsfdf/9187729846853701</a> "country list")</td>
</tr>
<tr>
<td style="text-align: left;">latitude_d</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">string</td>
<td>Installer code</td>
</tr>
<tr>
<td style="text-align: left;">currency</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">boolean</td>
<td>currency unit</td>
</tr>
<tr>
<td style="text-align: left;">longitude</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">boolean</td>
<td>longitude</td>
</tr>
<tr>
<td style="text-align: left;">latitude</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">boolean</td>
<td>latitude</td>
</tr>
<tr>
<td style="text-align: left;">timezone_id</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">int</td>
<td>The time zone code of the data display</td>
</tr>
<tr>
<td style="text-align: left;">plant_type</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">int</td>
<td>Power station type: 0: household power station, 1: industrial and commercial power station, 2: poverty alleviation power station</td>
</tr>
<tr>
<td style="text-align: left;">createDate</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">string</td>
<td>Created time</td>
</tr>
<tr>
<td style="text-align: left;">formulaMoney</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">float</td>
<td>Electricity price</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">string</td>
<td>city</td>
</tr>
<tr>
<td style="text-align: left;">plantAddress</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">string</td>
<td>City</td>
</tr>
</tbody>
</table>
<p><strong>Call example</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;">Value</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">c_user_id</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">74</td>
<td>User ID to which the power station belongs</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">is</td>
<td style="text-align: left;">bole66</td>
<td>power station name</td>
</tr>
<tr>
<td style="text-align: left;">peak_power</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">20</td>
<td>Peak power (kWp)</td>
</tr>
<tr>
<td style="text-align: left;">latitude_f</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Thailand</td>
<td>Region [Country List](<a href="https://www.showdoc.com.cn/v1/1313587669914582">https://www.showdoc.com.cn/v1/1313587669914582</a> "Country List")</td>
</tr>
<tr>
<td style="text-align: left;">latitude_d</td>
<td style="text-align: left;">no</td>
<td style="text-align: left;">AFLF6</td>
<td>Installer code</td>
</tr>
<tr>
<td style="text-align: left;">currency</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">$</td>
<td>Currency unit</td>
</tr>
<tr>
<td style="text-align: left;">longitude</td>
<td style="text-align: left;">no</td>
<td style="text-align: left;">30</td>
<td>longitude</td>
</tr>
<tr>
<td style="text-align: left;">latitude</td>
<td style="text-align: left;">no</td>
<td style="text-align: left;">22</td>
<td>latitude</td>
</tr>
<tr>
<td style="text-align: left;">timezone_id</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">8</td>
<td>Time zone code for data display</td>
</tr>
<tr>
<td style="text-align: left;">plant_type</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">1</td>
<td>Power station type: 0: Household power station, 1: Industrial and commercial power station, 2: Poverty alleviation power station</td>
</tr>
<tr>
<td style="text-align: left;">createDate</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">2022-10-13</td>
<td>Creation time</td>
</tr>
<tr>
<td style="text-align: left;">formulaMoney</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">1.4</td>
<td>Electricity Price</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">no</td>
<td style="text-align: left;">bankok</td>
<td>city</td>
</tr>
<tr>
<td style="text-align: left;">plantAddress</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">bankok</td>
<td>City</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;c_user_id&quot;: &quot;74&quot;,
&quot;name&quot;: &quot;bole66&quot;,
&quot;peak_power&quot;: &quot;20&quot;,
&quot;latitude_f&quot;: &quot;Thailand&quot;,
&quot;latitude_d&quot;: &quot;AFLF6&quot;,
&quot;currency&quot;: &quot;$&quot;,
&quot;longitude&quot;: &quot;30&quot;,
&quot;latitude&quot;: &quot;22&quot;,
&quot;timezone_id&quot;: &quot;8&quot;,
&quot;plant_type&quot;: &quot;1&quot;,
&quot;createDate&quot;: &quot;2022-10-13&quot;,
&quot;formulaMoney&quot;: &quot;1&quot;,
&quot;city&quot;: &quot;bankok&quot;,
&quot;plantAddress&quot;: &quot;bankok&quot;,
}</code></pre>
<p><strong>Return to Example</strong></p>
<pre><code>{
&quot;data&quot;: {
&quot;plant_id&quot;: 24832
},
&quot;error_code&quot;: 0,
&quot;error_msg&quot;: &quot;&quot;
}</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;">plant_id</td>
<td style="text-align: left;">int</td>
<td>Plant ID</td>
</tr>
<tr>
<td style="text-align: left;">error_code</td>
<td style="text-align: left;">int</td>
<td>error code</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>
<table>
<thead>
<tr>
<th style="text-align: left;">plant_id</th>
<th style="text-align: left;">error_code</th>
<th>error_msg</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">77</td>
<td style="text-align: left;">0</td>
<td>Return normally</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;error_msg&quot;: &quot;&quot;,
&quot;data&quot;: {
&quot;plant_id&quot;: 77
},
&quot;error_code&quot;: 0
}</code></pre>
<table>
<thead>
<tr>
<th style="text-align: left;">error_code</th>
<th style="text-align: left;">error_msg</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">10001</td>
<td style="text-align: left;">System error</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;error_msg&quot;: &quot;error_system error&quot;,
&quot;data&quot;: &quot;&quot;,
&quot;error_code&quot;: 10001
}</code></pre>
<table>
<thead>
<tr>
<th style="text-align: left;">error_code</th>
<th style="text-align: left;">error_msg</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">10002</td>
<td style="text-align: left;">Username ID is empty</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;error_msg&quot;: &quot;error_User ID is empty&quot;,
&quot;data&quot;: &quot;&quot;,
&quot;error_code&quot;: 10002
}</code></pre>
<table>
<thead>
<tr>
<th style="text-align: left;">error_code</th>
<th style="text-align: left;">error_msg</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">10003</td>
<td style="text-align: left;">The power station name is empty</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;error_msg&quot;: &quot;error_Plant name is empty&quot;,
&quot;data&quot;: &quot;&quot;,
&quot;error_code&quot;: 10003
}</code></pre>
<table>
<thead>
<tr>
<th style="text-align: left;">error_code</th>
<th style="text-align: left;">error_msg</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">10004</td>
<td style="text-align: left;">Peak power is empty</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;error_msg&quot;: &quot;error_Peak power is empty&quot;,
&quot;data&quot;: &quot;&quot;,
&quot;error_code&quot;: 10004
}</code></pre>
<table>
<thead>
<tr>
<th style="text-align: left;">error_code</th>
<th style="text-align: left;">error_msg</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">10005</td>
<td style="text-align: left;">User does not exist</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;error_msg&quot;: &quot;error_User does not exist&quot;,
&quot;data&quot;: &quot;&quot;,
&quot;error_code&quot;: 10005
}</code></pre>
<table>
<thead>
<tr>
<th style="text-align: left;">error_code</th>
<th style="text-align: left;">error_msg</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">10006</td>
<td style="text-align: left;">The power station name already exists under this user</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;error_msg&quot;: &quot;error_Plant name already exists under this user&quot;,
&quot;data&quot;: &quot;&quot;,
&quot;error_code&quot;: 10006
}</code></pre>
<p><strong>Remark</strong> </p>
<ul>
<li>The acquisition frequency is once every 5 minutes</li>
</ul>