自动化脚本开发
通过程序化的脚本处理,可以实现自动批量处理任务,例如任务的下发、任务的状态查询、任务的完成、业绩和产能交付的统计和结算等。通过集合 触动精灵+API接口 就可以快速实现自己想要的效果。做到自己控制自己的客户端、自己管理自己的数据,既快速又更安全。
例如触动精灵,是一款模拟手机触摸、按键操作的软件。通过制作脚本,可以让触动精灵代替双手,自动执行一系列触摸、按键操作。只要能够在手机上完成的人为操作,触动精灵都可以代替完成,不仅省力,而且高效。
小白API接口
在做自动化脚本时,你还需要存一些自己的应用数据,例如客户数据、订单数量、任务数据、素材物料数据这些。还需要在脚本调用API接口查询数据和创建修改数据。这时候,可以使用 YesApi.cn 小白API接口。
小白接口是一个低代码/零代码 API开发平台。提供在线数据表单,支持自定义数据表单和设计表字段,已收录9,000+张数据库表(一键安装)。表单字段:文本/图片/网址/数字/日期时间/人民币/百分比/JSON数据/下拉列表/其他。同时,提供500+API(45款常用数据接口)、支持接口DIY(15套接口模板)、近百个接口示例代码、支持API接口定制。接口分类有:应用接口/常用接口/数据接口/我的接口/定制接口/MySQL接口。
更好用的是,还可以很方便开发自己需要的API数据,有自己的开发能力:在线生成接口/在线开发调试/一键发布接口/接口复制/测试环境/中文编程/低代码。
怎么在脚本调用API接口?
如何请求YesApi小白接口?小白接口的调用,非常简单。
第1步:发起HTTP请求接口
第2步、解析JSON结果,用你的开发语言解析JSON结果,实现你的业务逻辑和功能。
例如:我在脚本请求的API接口链接是:
返回的JSON结果是:
{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi,欢迎使用小白开放接口!"},"msg":"","_t":1682135736,"_auth":"4bb469d44a2fe7df1f4e6967b46b550f"}
格式化一下JSON结果是,
{ "ret": 200, "data": { "err_code": 0, "err_msg": "", "title": "Hi YesApi,欢迎使用小白开放接口!" }, "msg": "", "_t": 1682135736, "_auth": "4bb469d44a2fe7df1f4e6967b46b550f" }
小白API有很多好用的功能,例如IP白名单/黑名单,可以防止别人恶意来刷流量;有接口签名和反向验证签名的双向验证,可以避免别人非法请求接口和破解修改服务端数据;还可以自己加密返回数据给客户端自己解密,提高数据安全;还可以自己添加根节点的返回结果字段;如果不需要返回JSON格式,也可以直接就返回一段文本字符串。
自动化脚本任务,需要怎么创建数据表单和添加字段?
做自动化脚本任务,大概的开发流程如下:
批量进行自动化任务时,首先,你要创建一个【任务表单】,这里用了 renwu 这个表单英文名(后面调用接口需要用到)。
同时根据业务需要,我自定义添加了几个表单字段:
- 任务数据 shuju;
- 任务目标数量 mubiao;
- 任务完成数量 wangcheng;
- 任务状态 zhuangtai;
- 客户名称 kehu;
建好后的表单结构,
下一步,先添加几条测试数据。
添加几条数据后,就可以看到列表数据了。
自动化脚本任务,有哪些常用基础的数据API接口?
添加和导入好任务数据后,需要最核心、最关键的接口就是获取非重复的任务数据接口。让客户端,可以向服务器获取一条需要下发执行的任务。
这时可以使用:
1)“阅后即焚”接口(专取非重复数据)接口
App.Table.FreePopOne |
1831 “阅后即焚”接口(专取非重复数据) |
查改 可以根据自定义的多个条件(AND或者OR),查找获取一条数据,并且在获取数据后更改字段,从而实现非重复数据的获取 |
2)或者:即用即删接口(专取非重复数据)接口
App.Table.DropOneByOne |
1833 即用即删接口(专取非重复数据) |
查删 根据主键id从小到大依次获取数据,取完就立即删除,从而实现非重复数据的获取。此接口即便在高并发下也能保证数据非重复。 |
“阅后即焚”接口(专取非重复数据)接口,是可以让你在保留任务数据的情况下,进行获取和更新任务。而 即用即删接口(专取非重复数据)接口,就是取一条任务就删除一条任务。
推荐使用 “阅后即焚”接口(专取非重复数据) 接口,它的功能说明如下:
可以根据自定义的多个条件(AND或者OR),查找获取一条数据,并且在获取数据后更改字段,从而实现非重复数据的获取。
前面我在任务表单加了一个【任务状态】的字段,【未开始】表示任务未下发未开始执行;【进行中】表示任务正在执行;【已完成】表示任务已完成。
下一步,就是调用接口在客户端获取一条新任务,接口调用是:
http://api.yesapi.cn/?&s=App.Table.FreePopOne&return_data=0&model_name=renwu&logic=and&where=[["zhuangtai", "=", "未开始"]]&data={"zhuangtai":"进行中"}&order_type=1
其中,where=[["zhuangtai", "=", "未开始"]] 表示我要取出任务状态为【未开始】的任务数据;data={"zhuangtai":"进行中"} 则表示取出数据后 把任务状态改为【进行中】,这样下次再查询就不会重复获取了。
这时,接口会给我返回以下新任务数据:
{ "ret": 200, "data": { "err_code": 0, "err_msg": "", "data": { "id": 1, "uuid": "", "add_time": "2023-04-22 13:20:22", "update_time": null, "ext_data": null, "shuju": "xxxxxxx", "mubiao": 10, "wangcheng": 1, "zhuangtai": "未开始", "kehu": "张三" }, "model_name": "renwu" }, "msg": "", "_t": 1682141385, "_auth": "f2ebf7ccdf88833a0260198a5353c0e7" }
取到新任务数据后,就可以交给脚本进行其他的自动化操作和处理了。
再查看表单列表数据,已经有一条数据更新为【进行中】了。
当任务进行中,需要上报完成的数量情况时,可以使用:
3)精确更改数值接口(可加可减)接口
App.Table.ChangeNumber |
1824 精确更改数值接口(可加可减) |
改 根据ID,修改某个字段的数值,可增加或可减少。通过在服务端进行数值的叠加,尽量保持并发下的数据一致性。 |
接口调用:
其中,接口参数 id=1 表示刚才那条新任务的ID;change_field=wangcheng 表示要改变的是【任务完成数量】,change_value=1表示完成数量+1。
接口返回结果:
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": "",
"change_value": "1",
"after_value": 2,
"model_name": "renwu"
},
"msg": "",
"_t": 1682141799,
"_auth": "8e02c1e7d2a341582dfcdd4b97fa0bfe"
}
最后,当任务完成目标完成时,可以再调用以下接口把任务状态改为【已完成】。
4)精确更新数据接口
App.Table.Update |
1809 精确更新数据接口 |
改 根据ID,更新自定义数据表单中的数据,更新的字段需要先存在。对系统保留表字段(id, uuid, add_time, update_time, ext_data)的更新将会被忽略。 |
接口请求:
http://api.yesapi.cn/?&s=App.Table.Update&return_data=0&model_name=renwu&id=1&data={"zhuangtai":"已完成"}
其中,接口参数 model_name=renwu 表示任务表单;id=1 指定哪条任务;data={"zhuangtai":"已完成"}要修改的任务状态为【已完成】。
接口返回:
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": "",
"model_name": "renwu"
},
"msg": "",
"_t": 1682142040,
"_auth": "973ce7f42c668f493238fdc021d3e6bb"
}
最后,再看一下任务表单到现在的数据。
上面就是最常用到的任务API接口。如果还需要其他API数据接口,可以看下这里的接口文档。
https://api.yesapi.cn/docs.php?api=App.Table
# |
请求方式 |
接口服务 |
接口名称 |
接口描述 |
1 |
GET/POST |
App.Table.Create |
1801 创建新数据接口 |
增 在自定义数据表单中添加一个新数据,添加的字段应先在后台进行添加。 |
2 |
GET/POST |
App.Table.CheckCreate |
1802 创建非重复新数据接口 |
增 在自定义数据表单中添加一个【非重复】新数据,添加的字段应先在后台进行添加。即当数据不存在时则创建,当数据已存在时不进行任何操作。 |
3 |
GET/POST |
App.Table.MultiCheckCreate |
1803 批量创建非重复新数据接口 |
批量增 批量操作,在自定义数据表单中添加一个【非重复】新数据,添加的字段应先在小白开放平台进行添加。 |
4 |
GET/POST |
App.Table.CheckCreateOrUpdate |
1804 创建或更新非重复新数据接口 |
增改 在自定义数据表单中尝试添加一个【非重复】新数据,如果数据已经存在,则进行更新操作。 |
5 |
GET/POST |
App.Table.MultiCheckCreateOrUpdate |
1805 批量创建或更新非重复新数据接口 |
批量增改 批量版接口,在自定义数据表单中尝试添加一个【非重复】新数据,如果数据已经存在,则进行更新操作。 |
6 |
GET/POST |
App.Table.MultiCreate |
1806 批量创建新数据接口 |
批量增 批量导入多条新数据,导入完毕后会返回导入的概况 |
7 |
GET/POST |
App.Table.MultiFastCreate |
1807 批量极速创建新数据接口 |
批量增 批量极速导入多条新数据,速度很快但无明细,此接口可用于批量导入数据,适用于数据初始化和还原。同时,值得注意的是,此接口因为接近原始的数据导入,因此可以设置小白系统字段:id(不提供时为自增主键)、uuid(用户登录时则自动绑定登录用户)、add_time(不提供时为当前创建时间)、update_time、ext_data。 |
8 |
GET/POST |
App.Table.MultiFastCreateExt |
1808 批量极速创建新数据接口[二分法递归增强版] |
批量增 批量极速导入多条新数据[二分法递归增强版],此接口的区别在于,若批量创建的数据失败,则会进行对半拆分分别重试创建,从而最大可能导入数据,最大重试深度为4级。其他功能请参见:批量极速创建新数据接口。 |
9 |
GET/POST |
App.Table.Update |
1809 精确更新数据接口 |
改 根据ID,更新自定义数据表单中的数据,更新的字段需要先存在。对系统保留表字段(id, uuid, add_time, update_time, ext_data)的更新将会被忽略。 |
10 |
GET/POST |
App.Table.MultiUpdate |
1810 批量ID更新数据接口 |
批量改 根据多个ID,批量更新自定义数据表单中的数据,更新的字段需要先存在。对系统保留表字段(id, uuid, add_time, update_time, ext_data)的更新将会被忽略。 |
11 |
GET/POST |
App.Table.FreeUpdate |
1811 自由批量更新数据接口 |
改 功能更强大的更新操作,可以根据自定义的多个条件(AND或者OR),更新指定的数据。为防止误更新全表数据,必须至少有一个有效条件。 |
12 |
GET/POST |
App.Table.Get |
1812 精确取数据接口 |
查 根据ID,获取自定义数据表单中的数据 |
13 |
GET/POST |
App.Table.GetDocx |
1813 生成并下载word文档 |
查 根据ID,获取自定义数据表单中的数据,并生成可直接下载的word文档。HTML内容将会被作为普通文本序列化输出。注意,仅当成功时才可下载word文档,失败时依然以接口JSON结果返回。 |
14 |
GET/POST |
App.Table.MultiGet |
1814 批量ID取数据接口 |
批量查 根据批量ID,批量获取自定义数据表单中的数据 |
15 |
GET/POST |
App.Table.Delete |
1815 精确删除数据接口 |
删 根据ID,删除自定义数据表单中的数据 |
16 |
GET/POST |
App.Table.MultiDelete |
1816 批量ID删除数据接口 |
批量删 根据多个ID,批量删除自定义数据表单中的数据 |
17 |
GET/POST |
App.Table.Count |
1817 获取总数接口 |
查 获取自定义数据表单中数据的总条目数量 |
18 |
GET/POST |
App.Table.FreeAF |
1818 分组聚合接口 |
查统计 统计接口,可以根据自定义的多个条件(AND或者OR),进行GROUP聚合操作运算 |
19 |
GET/POST |
App.Table.FreeCount |
1819 自由获取总数接口 |
查 可以根据自定义的多个条件(AND或者OR),获取总数 |
20 |
GET/POST |
App.Table.FreeExport |
1821 全量数据导出TXT或CSV或Excel接口 |
查 可以根据自定义的多个条件(AND或者OR),进行数据导出。成功导出时,此接口会直接生成可供下载的txt或csv文件。个人免费版最多导出5000条,VIP版最多可导出1万条,SVIP版最多可导出15万条。 |
21 |
GET/POST |
App.Table.FreeQuery |
1822 分页查询列表数据接口 |
查 分页获取列表数据或全部数据,支持字段选择、排序、条件查询,功能强大,是最为常用的数据接口。 |
22 |
GET/POST |
App.Table.FreeLeftJoinQuery |
1823 关联查询列表数据接口 |
查关联 有一定复杂度,但可实现功能强大的关联查询,以便实现同时获取两个表单的数据。根据自定义的多个条件(AND或者OR),进行搜索和查询,支持左关联查询,目前只支持关联一个表查询。可以通过文档示例增强对引接口的理解和使用,如有问题,请及时咨询技术客服。 |
23 |
GET/POST |
App.Table.ChangeNumber |
1824 精确更改数值接口(可加可减) |
改 根据ID,修改某个字段的数值,可增加或可减少。通过在服务端进行数值的叠加,尽量保持并发下的数据一致性。 |
24 |
GET/POST |
App.Table.FreeChangeNumber |
1825 自由更改数值接口(可加可减) |
改 可以根据自定义的多个条件(AND或者OR),修改某个或多个字段的数值,可增加或可减少。通过在服务端进行数值的叠加,尽量保持并发下的数据一致性。注意,此接口可更新多条数据。 |
25 |
GET/POST |
App.Table.MultiFreeChangeNumber |
1826 批量自由更改数值接口(可加可减) |
批量 改 可以根据自定义的多个条件(AND或者OR),批量修改某个或多个字段的数值,可增加或可减少。通过在服务端进行数值的叠加,尽量保持并发下的数据一致性。注意,此接口可更新多条数据。 |
26 |
GET/POST |
App.Table.FreeConcact |
1827 自由批量拼接字符串(可前可后) |
改 可以根据自定义的多个条件(AND或者OR),修改某个字段的字符串内容,可以在前面追加拼接,也可以拼接在后面。同时支持分割符。通过在服务端进行字符串的叠加,尽量保持并发下的数据一致性。注意,此接口可更新多条数据。 |
27 |
GET/POST |
App.Table.FreeFindOne |
1828 自由获取一条数据接口 |
查 可以根据自定义的多个条件(AND或者OR),查找获取一条数据 |
28 |
GET/POST |
App.Table.GetDataAfterChangeNum |
1829 加减后返回数据 |
查改 可以根据自定义的多个条件(AND或者OR),查找获取一条数据,然后对指定的字段进行加减操作,最后返回最新的数据。 |
29 |
GET/POST |
App.Table.FreeRandOne |
1830 随机获取一条数据接口 |
查 可以根据自定义的多个条件(AND或者OR),随机获取一条数据。获取数据后不会修改或删除数据。 |
30 |
GET/POST |
App.Table.FreePopOne |
1831 “阅后即焚”接口(专取非重复数据) |
查改 可以根据自定义的多个条件(AND或者OR),查找获取一条数据,并且在获取数据后更改字段,从而实现非重复数据的获取 |
31 |
GET/POST |
App.Table.FreePopAll |
1832 “阅后即焚”接口拓展(专取多条非重复数据) |
查改 可以根据自定义的多个条件(AND或者OR),查找获取多条数据(取全部或批量多条),并且在获取数据后批量更改字段,从而实现非重复数据的获取 |
32 |
GET/POST |
App.Table.DropOneByOne |
1833 即用即删接口(专取非重复数据) |
查删 根据主键id从小到大依次获取数据,取完就立即删除,从而实现非重复数据的获取。此接口即便在高并发下也能保证数据非重复。 |
33 |
GET/POST |
App.Table.FreeMin |
1834 自由获取最小值接口 |
查 可以根据自定义的多个条件(AND或者OR),获取某个字段的最小值 |
34 |
GET/POST |
App.Table.FreeMax |
1835 自由获取最大值接口 |
查 可以根据自定义的多个条件(AND或者OR),获取某个字段的最大值 |
35 |
GET/POST |
App.Table.FreeAggregation |
1836 自由聚合运算接口 |
查统计 可以根据自定义的多个条件(AND或者OR),进行SUM/COUNT/MIN/MAX/AVG等聚合运算,同时支持多个字段的聚合运算。 |
36 |
GET/POST |
App.Table.FreeSum |
1837 自由求和接口 |
查 可以根据自定义的多个条件(AND或者OR),计算某个字段的总和 |
37 |
GET/POST |
App.Table.FreeDelete |
1838 自由批量删除数据接口 |
删 可以根据自定义的多个条件(AND或者OR),删除多条数据。数据一旦删除,无法恢复,请谨慎操作! |
38 |
GET/POST |
App.Table.FreeMultiCal |
1839 批量四则运算接口 |
批量改 根据条件,批量进行四则运算,即:加/减/乘/除。例如,field=x,op=add,number=1,组合起来表示:x=x+1。 |
39 |
GET/POST |
App.Table.GetFiledDailyDataReport |
1840 获取单字段的每日统计报表 |
查统计 针对单个字段,获取两个周期内每日的统计报表,可以统计总数或总条目数量,即:sum({field}) 或 count({field})。 |
40 |
GET/POST |
App.Table.FreeTree |
1841 获取树状分类数据接口 |
查 可以根据自定义条件获取树状分类的数据,可用于:组织架构、目录分类、网站菜单、级联地址等场景。要求:表单结构中须含有指向父级的ID。当前最多一次性获取两层。 |
41 |
GET/POST |
App.Table.Transfer |
1842 点对点同级账号“转账”接口 |
改 在同一个表单内的同一字段,进行点对点同级“转账”操作。例如:把A账号的100积分转到B账号的积分。要求:转出和转入账号纪录已经存在且必须唯一;字段类型和“转账”数量均为整数;符合交换律和零和(即A转给B,然后B再转给A后,恢复和最初的一样)。 |
42 |
GET/POST |
App.Table.GetOneDataByOneField |
1843 根据单字段获取一条数据 |
查 根据一个字段快速获取其他字段的数据。 |
43 |
GET/POST |
App.Table.GetMoreDataByMoreField |
1844 根据多字段获取多条数据 |
查 根据一个字段或多个字段取一条或多条数据。最多返回20条。 |
44 |
GET/POST |
App.Table.GetFieldDropdownList |
1845 获取字段下拉列表 |
查 获取指定字段的下拉列表,全表去重后顺序显示。最多显示前面1000条。 |
45 |
GET/POST |
App.Table.FreeReplace |
1846 批量替换字符串字段 |
批量 改 针对表单的单个字段,根据指定的查找值和替换值进行自定义条件的批量替换 |
补充功能:怎么分享任务数据给好友?
如果需要给别人查看任务的实时情况,可以创建一个数据分享链接,别人只能查看不能修改,还能设置访问密码。
先创建一个【任务数据分享】链接,
然后就可以分享出去了,
到这里,就介绍完了。