# 转化 API

```
POST https://api.offer18.com/api/m/conversion
```

:link:[ <mark style="color:蓝色;">**点击测试转换 API**</mark> ](https://offer18.readme.io/reference/conversion-api)

### **通用参数**

<table data-header-hidden><thead><tr><th width="282.21480547854435">查询</th><th width="191.2954426994595"> </th><th> </th></tr></thead><tbody><tr><td><strong>查询</strong></td><td><strong>类型</strong></td><td><strong>描述</strong>  </td></tr><tr><td>mid</td><td>整数</td><td>网络账户 ID</td></tr><tr><td>api-key</td><td>字符串</td><td>网络 API 密钥</td></tr><tr><td>secret-key</td><td>字符串</td><td>网络密钥</td></tr></tbody></table>

***

### 筛选

| **主体**    | **类型** | **描述**                                                        |
| --------- | ------ | ------------------------------------------------------------- |
| tid       | 字符串    | <p>逗号分隔值<br>(限制 <strong>100</strong>)</p>                     |
| status    | 整数     | <p>允许的值<br><strong>1：批准</strong><br><strong>3：拒绝</strong></p> |
| event     | 字符串    | 可选                                                            |
| adv\_sub1 | 字符串    | 可选                                                            |
| adv\_sub2 | 字符串    | 可选                                                            |
| adv\_sub3 | 字符串    | 可选                                                            |
| adv\_sub4 | 字符串    | 可选                                                            |
| adv\_sub5 | 字符串    | 可选                                                            |

***

### **示例 API 请求**

![](https://2550316299-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2FEP46x2fmzv7WPqlQ8y3n%2Fimage.png?alt=media\&token=5d68afff-f049-48b8-92b0-fc2f1a18e297)

***

### **API 响应**

```
{ 
    "status": "200",
    "affected": 2,
    "affected_tid": [ 
        "D-0001-v834hbsuf45gdfd", 
        "D-0001-p0345ns0v823h4" 
    ] 
}
```

{% hint style="warning" %}
早于以下时间的转换 **4 个月** 不允许更改状态。
{% endhint %}

***

{% hint style="info" %}
**为保证交互安全，请始终从服务器端调用 API。**
{% endhint %}