2.2 Modifying the power station
<p><strong>A brief description:</strong> </p>
<ul>
<li>Modify the interface of the power station</li>
</ul>
<p><strong>Request URL: </strong></p>
<ul>
<li><code>http(s)://test.growatt.com/v1/plant/modify</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;">Whether 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 plant belongs</td>
</tr>
<tr>
<td style="text-align: left;">plant_id</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">int</td>
<td>Power Station ID</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;">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;">peak_power</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">boolean</td>
<td>peak power (kWp)</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>Time zone code for data display: East time zone: 1~12 West time zone: -1~-12</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>
</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;">plant_id</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">77</td>
<td>Plant ID</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">20</td>
<td>Power station name</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;">peak_power</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">20</td>
<td>Peak power (kWp)</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;">23</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 displayed by data: East time zone: 1~12 West time zone: -1~-12</td>
</tr>
<tr>
<td style="text-align: left;">plant_type</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">0</td>
<td>Power station type: 0: Household power station, 1: Industrial and commercial power station, 2: Poverty alleviation power station</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;c_user_id&quot;: &quot;74&quot;,
&quot;plant_id&quot;: &quot;77&quot;,
&quot;name&quot;: &quot;bole66&quot;,
&quot;latitude_f&quot;: &quot;Thailand&quot;,
&quot;latitude_d&quot;: &quot;AFLF6&quot;,
&quot;peak_power&quot;: &quot;20&quot;,
&quot;currency&quot;: &quot;$&quot;,
&quot;longitude&quot;: &quot;30&quot;,
&quot;latitude&quot;: &quot;23&quot;,
&quot;timezone_id&quot;: &quot;8&quot;,
&quot;plant_type&quot;: &quot;0&quot;
}</code></pre>
<p><strong>Return to Example</strong></p>
<pre><code>{
&quot;data&quot;: &quot;&quot;,
&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;">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;">error_code</th>
<th style="text-align: left;">error_msg</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">0</td>
<td style="text-align: left;">Return normally</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;data&quot;: &quot;&quot;,
&quot;error_code&quot;: 0,
&quot;error_msg&quot;: &quot;&quot;
}</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&quot;,
&quot;data&quot;: &quot;&quot;,
&quot;error_code&quot;: 10006
}</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;">10007</td>
<td style="text-align: left;">The power station does not exist</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;error_msg&quot;: &quot;error_Plant does not exist&quot;,
&quot;data&quot;: &quot;&quot;,
&quot;error_code&quot;: 10007
}</code></pre>
<p><strong>Remark</strong> </p>
<ul>
<li>This interface is only allowed to be called 10 times a day</li>
</ul>