# 应用端 API 说明 应用端 API 是指由应用端提供，供抽奖工坊调用的接口。 抽奖工坊奖通过 http POST - application/x-www-form-urlencoded 方式，将相关数据推送给应用端。 ## **设置应用端 API 地址，以及获得生成 token 的 secret** 开发者必须奖应用端的 API 地址设置到抽奖工坊中，这样在需要调用应用端的 API 的时候，抽奖工坊才知道要通过哪个网址。请在 抽奖工坊管理平台 -> 系统设置 -> 用户模式 -> API模式 中设置应用端的API的地址。 同时应用端也需要校验 token 的有效性，使用的 secret 也从上述设置页面中获取。 >[info] **PS：奖工坊后台设置中只能设置一个应用端 API 地址，但是 API 是有多个的， 怎么处理？** > ***** > 抽奖工坊调用应用端 API 的时候，使用统一的地址。并通过 POST 参数 api 的值，来区分不同的请求。 > 例如在 联通测试 中，POST 参数的 api 将传入 ping，而在发放奖品的时候 api 将传入 issue_prize。 > 开发者必须根据传入的 api 参数来进行不同的操作和进行响应。 >[info] **PS：关于时间戳 (Unix timestamp) time 参数的说明** > 云端往应用端的每个 API 请求都会包含一个时间戳 (Unix timestamp) time 参数，建议应用端对这个时间戳进行检查。比如请求到达时间与这个时间戳相差超过 30 秒就拒绝（可返回请求超时提示），从而防止已用过的 API 请求信息被二次利用。同时包含此参数，还可以防止在没有额外参数参与 token 生成的情况下 token 用来破解 secret 信息。