# 通过 API 批量修改或逆转

<a href="https://pxa.impact.com/student/activity/2268418?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">参加 PXA 课程</a>

如果某个动作的任何内容发生变化（例如，订单被取消、商品被退货等），您可以使用 API 对其进行修改（或反向处理），从而更改该动作的佣金金额。&#x20;

### 哪种提交方式最适合你？

### API 反向处理选项：

* [通过 API 修改或反向处理一个或多个动作中的商品](https://integrations.impact.com/impact-brand/reference/update-an-action-item)
* [通过 API 反向处理整个动作](https://integrations.impact.com/impact-brand/reference/reverse-an-action)

### 前提条件：检索 *ActionId* 值

要通过 API 修改动作数据，您需要其 `ActionId` 值。然后，您可以使用它通过 API 找到要修改的动作。

* 您可以在调用中指定日期范围——否则，该端点默认显示最近 30 天的动作。
* [速率限制](https://integrations.impact.com/impact-brand/reference/rate-limits) 适用。
* 查看 [列出所有动作](https://integrations.impact.com/impact-brand/reference/list-all-actions) API 端点文档以了解更多信息。

### 常见问题

<details>

<summary>如何重置对某个动作（或动作商品）所做的修改 / 反向处理？</summary>

如果某个动作在其锁定日期之前已被修改或反向处理，您可以提交 `RESET` 作为原因，将该动作更新回其默认状态：

```programlisting
curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \\
  -X PUT \\
  -u '{AccountSID}:{AuthToken}' \\
  -H 'Accept: application/json' \\
  -H 'Content-Type: application/x-www-form-urlencoded' \\
  -d 'ActionId={ActionId}' \\
  -d 'Reason=RESET'
```

通过 `RESET` 代码重置的动作可能不会在报告中正确显示（例如，收入值可能计算错误）。

</details>

<details>

<summary>处置代码与原因有什么区别？</summary>

两者 *处置代码* 和 *原因* 都在相同的上下文中使用—— *原因* 是 API 默认接受的预定义代码，而 *处置代码* 是您可以配置的自定义原因。 [了解有关处置代码的更多信息](https://help.impact.com/brand/zh/nin-xiang-liao-jie-shen-me/platform-features/tracking/set-up-tracking/manage-disposition-codes).

支持的原因代码：

</details>

<details>

<summary>我如何查看修改 / 反向处理何时应用到某个动作？</summary>

您可以使用 [动作更新](https://integrations.impact.com/impact-brand/reference/the-action-update-object) 端点查看某个动作最后一次更新的时间以及其当前状态。

{% hint style="info" %}
**注意：** 一项 `ActionUpdatesID` 值与 `ActionId` 值不同——您必须使用 `ActionUpdatesID` 值来检索某个动作的更新。
{% endhint %}

</details>