PRA10.3 平台 API 接口调用

学Python ,用RPA，艺赛旗RPA 2020.1全新首发免费下载点击下载

www.i-search.com.cn/index.html?from=line1

适用版本
适用于RPA10.3以及以上版本
接口 API 手册
调用方式及字段，请参考论坛手册：
http://support.i-search.com.cn:8088/showdoc/web/#/73?page_id=2030

接口签名规则
1.1 Headers
API 请求的 Headers 中有 appkey，timestamp，signature 三个参数。

appkey 与服务端管理员联系获取（系统 - 系统设置 - 应用接口中获取）。

timestamp 是当前请求的时间戳（毫秒）。

signature 是接口签名认证，具体签名规则参考下一下节

1.2 接口签名认证
1.2.1 构造源串
把所有请求参数，按照字典升序排列，即：原先为 {”b”:”b”,”a”:”a”,”c”:”c”｝, 排序后为 {”a”:”a”,”b”:”b”,”c”:”c”｝

POST/GET /DELETE 请求处理
将排序后的 json 参数 (key=value) 用 & 拼接起来，即：a=a&b=b&c=c

PUT 请求处理
将排序后的 json 参数转化成 str，即：’ {”b”:”b”,”a”:”a”,”c”:”c”}’

经过排序过后的仅仅是源串的一部分，还要在它的基础上按顺序加上 appkey，timestamp，
参考示例：

‘a=a&b=b&c=c&appkey=1aadd9d5ca2942fdbe50d0b849120977×tamp=1574821902392’

或

‘{”a”:”a”,”b”:”b”,”c”:”c”}&appkey=1aadd9d5ca2942fdbe50d0b849120977×tamp=1574821902392’

1.2.2 URL 编码
在第一步“构造源串”中得到的字符串，在此步骤中用来 URL 编码!

除了用普通方法来 URL 编码外，还有几个字符需要特殊处理。

Java 方法：

String sources =
getSourceParameters(); // 第一步“构造源串”

String newSources
= URLEncoder.encode(sources, “UTF8”)

newSources =
newSources.replace(“+”, “+”)；

newSources = newSources.replace(“*”, “%2A”)；

newSources =
newSources.replace(“~”, “%7E”)；

1.2.3 HMAC256 加密
对在第二步得到的字符串进行 HMAC256 编码

注：HMAC256 编码的加密密码 key 为之前的 appkey

1.2.4 Base64 加密
在 HMAC256 加密之后，再进行一次 Base64 加密

1.2.5 去掉 \r\n 特殊字符
去掉 Base64 加密后之后的 \r\n，然后就得道最终的签名!

请求方式说明
GET：
Headers：{‘Content-Type’: ‘application/json; charset=UTF-8’}

params:json 字符串

POST：
Headers：无需定义 Content-Type

params:json 字符串

DELETE：
Headers：{‘Content-Type’: ‘application/json; charset=UTF-8’}

params:json 字符串

PUT：
源串生成：请参考 1.2.1 节“PUT 请求处理”

Headers：{‘Content-Type’: ‘application/json; charset=UTF-8’}

Body: 需要 raw 形式发送 json 信息

签名生成示例：
3.1 源串
robotName=x&robotIp=x&robotStatus=x&page=1&size=10

3.2 排序后：
page=1&robotIp=x&robotName=x&robotStatus=x&&size=10

3.3 加上 appkey，timestamp：
page=1&robotIp=x&robotName=x&robotStatus=x&&size=10&appkey=1aadd9d5ca2942fdbe50d0b849120977×tamp=15748219023

3.4 URL 编码后：
page%3D1%26robotIp%3Dx%26robotName%3Dx%26robotStatus%3Dx%26%26size%3D10%26appkey%3D1aadd9d5ca2942fdbe50d0b849120977%26timestamp%3D15748219023

3.5 HMAC256 加密：
37f3d9ec02bff028f364e4c99050ecf50a352be2ede3d69c3e71abbbb73ec328

3.6 Base64 加密：
MzdmM2Q5ZWMwMmJmZjAyOGYzNjRlNGM5OTA1MGVjZjUwYTM1MmJlMmVkZTNkNjljM2U3MWFiYmJiNzNlYzMyOA==

3.7 获得签名
对上一步获得的字符串进行处理，去掉 \r\n：

MzdmM2Q5ZWMwMmJmZjAyOGYzNjRlNGM5OTA1MGVjZjUwYTM1MmJlMmVkZTNkNjljM2U3MWFiYmJiNzNlYzMyOA==

这个就是最终的接口签名值，需要 header 在里面传递!

Python 调用代码
如果想用机器人来调 API 接口，可参考以下代码，其它语言逻辑一样:

import json
import time
import requests
from urllib import parse
import hmac
import base64
from hashlib import sha256

def rpa_rest_10(host,rest_type,data_json,appkey,mode=‘get’,port=10080,try_times=2):
‘’’
host:地址，str型，示例：‘http://192.168.202.150’
rest_type:str型，接口类型，示例：’/api/v2/jobs’
data_json:字典型，发送的报文数据json格式
appkey:str型，服务平台应用Key
mode:接口请求方式（get、post、delete及put）
port:int型，http端口
try_times:int型，重试次数
返回值：get_field_json:字典型，
‘’’
count = 0
get_field_json={‘code’: 4, ‘msg’: ‘fail,发送API消息遇到严重错误！’,‘result’:None}
if mode != ‘get’ and mode != ‘put’ and mode != ‘post’ and mode != ‘delete’:
get_field_json={‘code’: 40, ‘msg’: ‘fail,mode错误,只能为get、put、post或delete！’,‘result’:None}
#获得签名sign
sign=’’
try:
#源串:sign_yc
#获得毫秒级时间戳（时间出入不能大于10分钟）
timestamp=str(int(round(time.time() * 1000)))
sign_yc=’’
#处理json数据不为str类型的情况
for key in data_json:
data_json[key]=str(data_json[key])
#json排序
data_json=json.dumps(data_json,sort_keys=True)
if mode == ‘put’:
sign_yc=str(data_json) + ‘&appkey=’ + appkey + ‘&timestamp=’ + timestamp
url = host + ‘:’ + str(port) + rest_type
else:
#生成源串
json_str=str(data_json).replace(’": “’, ‘=’)
json_str=json_str.replace(’”, “’, ‘&’)
json_str=json_str.replace(’{”’, ‘’)
json_str=json_str.replace(’"}’, ‘’)
sign_yc=json_str + ‘&appkey=’ + appkey + ‘&timestamp=’ + timestamp
url = host + ‘:’ + str(port) + rest_type + ‘?’ + json_str
#URL编码
url_bm = parse.quote(sign_yc)
#sha256加密密码
byte_key = bytes(appkey, encoding=“utf-8”)
byte_url_bm = bytes(url_bm, encoding=“utf-8”)
hn256 = hmac.new(byte_key, byte_url_bm, digestmod=sha256)
hh256 = hn256.hexdigest()
#Base64编码
bb64 = base64.b64encode(bytes(hh256, encoding=“utf-8”))
#获取sign
sign = str(bb64, “utf-8”)
#替换\r\n
sign=sign.replace(’\r\n’, ‘’)
except Exception as e:
print(e)
#开始尝试发送API
while True:
try:
header_dict = {‘appkey’:appkey,‘timestamp’:timestamp,‘signature’:sign}
try:
if mode==‘post’:
res = requests.post(url, data=json.dumps(data_json), headers=header_dict)
if mode==‘get’:
res = requests.get(url,headers=header_dict)
if mode==‘put’:
header_dict = {‘Content-Type’: ‘application/json; charset=UTF-8’,‘appkey’:appkey,‘timestamp’:timestamp,‘signature’:sign}
#body要raw形式发送
res = requests.put(url, data=str(data_json), headers=header_dict)
if mode==‘delete’:
res = requests.delete(url, data=json.dumps(data_json), headers=header_dict,verify=False)
except Exception as e:
print(‘打印错误日志：’,e)
#获取返回值
res_text=res.text
#转化成json
get_field_json=json.loads(res_text)
break
except Exception as e:
print(‘尝试失败：’,e)
time.sleep(1)
finally:
count += 1
if count >= try_times:
break
return get_field_json

其它平台或客户端调用
5.1 其它平台调用
按照第 4 章的逻辑自行写调用代码即可。

5.2 机器人调用
按照第 4 章添加一个全局函数，在需要调用的地方使用全局函数控件即可。

PRA10.3 平台 API 接口调用相关推荐

PRA10.3平台API接口调用
学Python,用RPA 艺赛旗RPA2020.1版本正在免费下载使用中,欢迎下载使用 www.i-search.com.cn/index.html?from=line1 适用版本适用于RPA10 ...
PRA2020.4 平台 API 接口调用
关注RPA请访问网站: www.i-search.com.cn 学Python,用RPA,欢迎下载使用 www.i-search.com.cn/index.html?from=line1 适用版本适 ...
短信平台API接口调用-SUBMAIL
一.下载SDK开发包前往文档中心 ->SDK 开发包下载页面,下载对应语言的SDK开发包. SUBMAIL 提供多种语言的开发包,SDK 集成了 SUBMAIL 的 API 请求方法,并将 A ...
1688、京东、拼多多各大电商平台API接口调用示例
以下是行业内了解到的一些情况,本帖只展示部分代码,需要更多API调试请移步注册API账号 http://console.open.onebound.cn/console/?i=Merissa { ...
各大电商平台API接口调用、拼多多API接口获得淘宝商品详情
本帖只展示部分代码及接口需了解更多或开发系统请移步注册测试 http://console.open.onebound.cn/console/?i=Rookie 请求地址: http://open.o ...
各大电商平台API接口调用、拼多多API接口根据ID取商品详情原数据
本帖只展示部分代码及接口需了解更多或开发系统请移步注册测试 http://console.open.onebound.cn/console/?i=Rookie { "item": ...
淘宝、1688、拼多多等各大电商平台API接口调用展示
以下是部分代码展示,需要更多了解调试请移步 http://console.open.onebound.cn/console/?i=Rookie { "items": { " ...
淘宝、1688、拼多多等各大电商平台API接口调用展示(拼多多API根据关键词取商品列表)
以下是部分代码展示,需要更多了解调试请移步 http://console.open.onebound.cn/console/?i=Rookie { "items": { " ...
各大电商平台API接口调用展示
以下是部分代码展示,需要更多了解调试请移步 http://console.open.onebound.cn/console/?i=Rookie Request address: https://api ...

PRA10.3 平台 API 接口调用

PRA10.3 平台 API 接口调用相关推荐

最新文章

热门文章