上面是具体开发文档地址,看不明白下面的可以点上面链接看看,不太懂JS,谁能按这个文档写个简单例子学习下吗,我自己百度搜了这一类例子没找到,也可能是我操作方法不对,我试了用常量、用JS赋值、直接打文本提交都不行。 例如 账号:奥利给,密码:123456,token:1a2b3c4d5e,这种应该怎么写。
比如我们想要通过API获取账户的基础信息,那么调用接口就为:
2、了解请求格式明确了API请求接口后,下面就是要明确接口的请求信息了,我们先来简单介绍下API的请求格式: { "header": { //账户信息 }, "body": { //具体请求参数,取决于接口 }}发送的请求是一个JSON格式的字符串,其中header 和 body属性都是必需的。 说明:这里所说的header、body均为自定义字段,而非Http下的Header 和 Body header(账户信息)中需要填写您的API账户名、密码、token等信息,视您申请的API权限而略有差异。 body(具体请求参数)的内容取决于接口要求。
3、设置header信息header作为请求参数的一个必要字段(设置在Http Body下),所包含的信息比较简单,主要用于鉴权。针对具体API权限的账户请求的header信息是固定的,不会受接口变化的影响,以我们基础的普通账户为例,header信息如下。 "header": { "username":"searchlab", // 推广账户名,需已开通API权限 "password":"key******", // 账户密码 "token":"6d6eb8ca767******" // 权限代码(token)信息 }4、设置body信息body是请求参数中的一个自定义的必要字段(设置在Http Body下),具体格式同请求的接口相对应,可以简单理解为业务参数,直接决定了您通过该接口可以获取的信息,因此body信息是与接口强依赖的,具体到我们上面所说的getAccountInfo(获取账户信息),我们可以通过接口文档了解到,具体的请求格式、参数和要求。
-输入信息:getAccountlnfoRequest
属性名 | 类型 | 说明 | 限制 | accountFields | string[] | 指定需要返回的属性 | 取值范围:
请参考表AccountFields
Userid默认返回。不请求的属性
没有返回值。 |
可以看到该接口的输入信息只有accountFields这一个string[]类型的属性,通过描述可以了解到,该属性决定了希望通过接口获取的账户参数。 通过参考表AccountFields可了解到具体的可请求的参数,比如我们要获取账户预算和余额,那么可以找到预算和基础余额的参数名: - 预算:budget
- 余额:balance(部分客户的余额资金包可能会比较复杂,我们先以基础情况介绍)
同时可以参考代码示例,确定获取通过获取账户预算和余额的请求信息应为: "body": { "accountFields": ["budget","balance"] }5、调用请求以上我们确定了具体的接口和请求信息,下面我们就可以正式尝试进行调用了 说明:为了方便介绍说明,我们用API调试工具postman来为大家演示一个仅API接口层面的调用,实际工作中具体的调用更多的是在您的应用程序中进行的。所有接口的调用方式均为HTTP POST,不支持GET等其他方式调用。 可看到接口返回中提供的具体的预算和余额信息 以上就是一个最简单的API调用案例介绍,实际应用中如果要了解其他很多相关的知识和内容,但是基础逻辑是相通的。
|