api接口文档

合集下载

开发接口文档-API文档模板

开发接口文档-API文档模板

code messageXXX项目接口文档1获取所有字段1.1获取所有宇段请求地址:/session/field/findAII响应10000成功f -1系统错误,10001必填参数为空响应描述如响应例子请求例子:http://127.0.0.1:8080/session/field/findAII?name=X 响应例子:{\ode H:-10000M f M exception":null f M isSuccess-:true/,message rt:-^ f系统处理正常!"/page":0/pageSize":0/returnObject":null/retumValue•:{"types^null/villages^null/companys^H^conC olour 丫Ticon SizelOJconStyle•:•丁icT:4「name 丫XXXiconColour 丫TiconSizelO/iconStyle•: ■:・icT:5/ nameTXX”},{”iconColourTTiconSize・:(TiconStyle”:・Ticr:7「name・:-X X”}]}「totals・:0}2文件上传2.1文件上传(ajax)请求地址:/session/file/upload 请求参数formData.append("file M f this.files[O]);$.ajax({url: routePath + "/session/file/upload"ftype : TOST;data : formData,processData : false,contentType : false, success : function (result) {result = JSON.parse(result);if(result.code== -10000M){layer.msg(上传成功! *);$(M#editHeadPortrait M).val(result.returnValue.filePath);}}});响应例子:returnValue 里包含了fileName 和filePath3字段管理•所属类型3.1新熠所属类型请求地址:/session/fieldType/save响应响应例子:{"code^^lOOOO'/'exception^null/isSuccess^true/'message*:*^^ ,系统处理正箒! "/page^O/pageSize^O/returnListSize^O/returnObject^null/returnValue^null/totals^O}3.2修改所属类型请求地址:/session/fieldType/update 请求参数响应请求例子:http://127.0.0.1:8080/session/fieldType/update?id=2&name二test响应例子:{"code^/lOOOO^'exception^null/isSuccess^true/'message^/fiE% f系统处理正常!•/page":0/pageSize":0/returnListSize B:0/retumObject":null/returnValue R:null r"totals":0}3.3根据id获取所属类型请求: /session/fieldType/getByld 请求参数响应例子:{"code^/lOOOO'/'exception^null/isSuccess^true/^message'/fiJ^t) f 系统处理正常! "/page H :0/pageSize ,,:0/returnListSize":0/returnObject M :null/returnValue":rid e :2/',name":,,re -}f H totals ,,:0}3.4获取所属类型列表请求: /session/fieldType/selectAII请数请求例子:http://127.0.0.1:8080/session/fieldType/selectAII?name=l 响应例子:{"code^/lOOOO'/'exception^null/isSuccess^true/'message^'sJ^J f 系统处理正箒! ;-page":0/pageSize":0/returnObject R :null/returnValue\[rid":l ;name\"123"}X"id\6r w name":-145555"}] /totals":2}3.5删除所属类型(批星)请求地址:/session/fieldType/deleteBylds 请求参数响应例子:{"code^/lOOOO'/'exception^null/isSuccess^true/'message'/fiJ^i] f 系统处理正常! "/page^O/pageSize^O/retumListSize^O/returnObject^null/returnValue^null/totals^O}。

API接口文档

API接口文档

API接口文档最后更新日期:2013-05-16一、添加域名接口 (6)1、接口调用地址 (6)2、传入参数 (6)3、输出数据 (6)二、删除域名接口 (7)1、接口调用地址 (7)2、传入参数 (7)3、输出数据 (7)三、添加用户接口 (8)1、接口调用地址 (8)2、传入参数 (8)3、输出数据 (8)四、获取用户信息接口 (9)1、接口调用地址 (9)2、传入参数 (9)3、输出数据 (9)五、搜索用户接口 (10)1、接口调用地址 (10)2、传入参数 (10)3、输出数据 (10)六、修改用户接口 (11)1、接口调用地址 (11)2、传入参数 (11)3、输出数据 (12)七、删除用户接口 (13)1、接口调用地址 (13)2、传入参数 (13)3、输出数据 (13)八、获取邮箱别名接口 (14)1、接口调用地址 (14)2、传入参数 (14)3、输出数据 (14)九、获取部门列表接口 (15)1、接口调用地址 (15)2、传入参数 (15)3、输出数据 (15)十、添加部门接口 (17)1、接口调用地址 (17)3、输出数据 (17)十一、修改部门接口 (18)1、接口调用地址 (18)2、传入参数 (18)3、输出数据 (18)十二、删除部门接口 (19)1、接口调用地址 (19)2、传入参数 (19)3、输出数据 (19)十三、获取部门成员接口 (20)1、接口调用地址 (20)2、传入参数 (20)3、输出数据 (20)十四、添加部门成员接口 (21)1、接口调用地址 (21)2、传入参数 (21)3、输出数据 (21)十五、删除部门成员接口 (22)1、接口调用地址 (22)2、传入参数 (22)3、输出数据 (22)十六、添加别名接口 (23)1、接口调用地址 (23)2、传入参数 (23)3、输出数据 (23)十七、修改别名接口 (24)1、接口调用地址 (24)2、传入参数 (24)3、输出数据 (24)十八、删除别名接口 (25)1、接口调用地址 (25)2、传入参数 (25)3、输出数据 (25)十九、获取POP接收邮件接口 (26)1、接口调用地址 (26)2、传入参数 (26)3、输出数据 (26)二十、添加POP接收邮件接口 (27)1、接口调用地址 (27)2、传入参数 (27)3、输出数据 (27)二十一、修改POP接收邮件接口 (28)1、接口调用地址 (28)3、输出数据 (28)二十二、删除POP接收邮件接口 (29)1、接口调用地址 (29)2、传入参数 (29)3、输出数据 (29)二十三、获取邮件列表接口 (30)1、接口调用地址 (30)2、传入参数 (30)3、输出格式 (30)二十四、查看邮件接口 (31)1、调用方式 (31)2、传入参数 (31)3、输出格式 (31)二十五、客户端连机检测接口 (32)1、接口调用地址 (32)2、传入参数 (32)3、输出数据 (32)二十六、单点登录 (33)1、登录方法 (33)2、传入参数 (34)二十七、冻结/解冻用户帐号接口 (36)1、接口调用地址 (36)2、传入参数 (36)3、输出数据 (36)二十八、获取冻结用户帐号接口 (37)1、调用方式 (37)2、传入参数 (37)3、输出格式 (37)二十九、获取显示已存在的邮件列表接口 (37)1、调用方式 (37)2、传入参数 (37)3、输出格式 (37)三十、添加邮件列表接口 (38)1、调用方式 (38)2、传入参数 (38)3、输出格式 (38)三十一、修改邮件列表接口 (38)1、调用方式 (38)2、传入参数 (39)3、输出格式 (39)三十二、删除邮件列表接口 (39)1、调用方式 (39)3、输出格式 (39)三十三、显示邮件列表成员接口 (40)1、调用方式 (40)3、输出格式 (40)三十四、添加邮件列表成员接口 (40)1、调用方式 (40)2、传入参数 (41)3、输出格式 (41)三十五、删除邮件列表成员接口 (41)1、调用方式 (41)2、传入参数 (41)3、输出格式 (41)三十六、更新邮件列表成员属性接口 (42)1、调用方式 (42)2、传入参数 (42)3、输出格式 (42)三十七、获取个人通讯录分组列表* (42)1、调用方式 (42)2、传入参数 (42)3、输出格式 (43)三十八、获取个人通讯录指定分组下的联系人列表* (43)1、调用方式 (43)2、传入参数 (43)3、输出格式 (44)三十九、获取个人通讯录联系人信息* (44)1、调用方式 (44)2、传入参数 (45)3、输出格式 (45)四十、添加个人通讯录分组* (46)1、调用方式 (46)2、传入参数 (46)3、输出格式 (46)四十一、修改个人通讯录分组* (47)1、调用方式 (47)2、传入参数 (47)3、输出格式 (47)四十二、删除个人通讯录分组* (48)1、调用方式 (48)2、传入参数 (48)3、输出格式 (48)四十三、添加联系人* (48)1、调用方式 (48)2、传入参数 (49)3、输出格式 (49)四十四、修改联系人* (50)1、调用方式 (50)2、传入参数 (50)3、输出格式 (51)四十五、删除联系人* (51)1、调用方式 (51)2、传入参数 (51)3、输出格式 (51)四十六、添加联系人分组信息* (52)1、调用方式 (52)2、传入参数 (52)3、输出格式 (53)四十七、删除联系人分组信息* (53)1、调用方式 (53)2、传入参数 (53)3、输出格式 (54)一、添加域名接口1、接口调用地址http://domain/webmail/api/addDomain.php?adminpass=xxx&domain=&quota=1 5000&userlimit=150&userquota=100&netfilequota=50&allowreg=on&created=2009-04 -23&ended=2013-01-01&password=1234562、传入参数需要以GET方式传递以下参数:●adminpass: 超级管理员MD5后的密码●domain: 要添加的域名,例如“”●quota: 此域的空间限额,单位为M。

腾讯对外接口API文档

腾讯对外接口API文档

打开以下网址,输入您的腾讯绑定帐号以及密码:/index.php/API%E6%96%87%E6%A1%A3类似这样的:API文档返回出自腾讯微博开放平台跳转到:导航, 搜索OAuth授权时间线微博相关帐户相关关系链相关私信相关搜索相关热度,趋势数据更新相关数据收藏话题相关标签相关名单微群相关邀请相关LBS相关其他文档更新历史API问题QA错误码说明表情列表下载OAuth授权request_token 获取request_tokenauthorize 用户授权request_tokenaccess_token 交换access_tokenaccess_token 交换access_token点击查看示例API请求示例说明auth/get_oauth2_token 通过oAuth1.0的token获取oAuth2.0的token时间线statuses/home_timeline 主页时间线statuses/public_timeline 广播大厅时间线statuses/user_timeline 其他用户发表时间线statuses/mentions_timeline 用户提及时间线statuses/ht_timeline 话题时间线(建议使用新话题时间线接口ht_timeline_ext) statuses/broadcast_timeline 我发表时间线statuses/special_timeline 特别收听的人发表时间线statuses/area_timeline 地区发表时间线statuses/home_timeline_ids 主页时间线索引statuses/user_timeline_ids 其他用户发表时间线索引statuses/broadcast_timeline_ids 我发表时间线索引statuses/mentions_timeline_ids 用户提及时间线索引statuses/users_timeline 多用户发表时间线statuses/users_timeline_ids 多用户发表时间线索引statuses/ht_timeline_ext 话题时间线statuses/home_timeline_vip 拉取vip用户发表微博消息接口statuses/sub_re_list 获取二传手列表(获取转播或评论的再次转播或评论列表)微博相关t/show 获取一条微博数据t/add 发表一条微博t/del 删除一条微博t/re_add 转播一条微博t/reply 回复一条微博(即对话)t/add_pic 发表一条带图片的微博t/re_count 转播数或点评数t/re_list 获取单条微博的转发或点评列表t/comment 点评一条微博t/add_music 发表音乐微博t/add_video 发表视频微博t/getvideoinfo 获取视频信息t/list 根据微博id批量获取微博内容(与索引合起来用)t/sub_re_count 获取转播的再次转播数(二次转发次数)t/add_emotion 发表心情帖子t/add_pic_url 用图片URL发表带图片的微博t/add_multi 多类型发表(可同时发表带音频、视频、图片的微博)帐户相关user/info 获取自己的详细资料user/update 更新用户信息user/update_head 更新用户头像信息user/update_edu 更新用户教育信息user/other_info 获取其他人资料user/infos 获取一批人的简单资料user/verify 验证账户是否合法(是否注册微博)user/emotion 获取心情微博关系链相关friends/fanslist 我的听众列表friends/fanslist_name 我的听众列表,只输出namefriends/idollist 我收听的人列表friends/idollist_name 我收听的人列表,只输出namefriends/blacklist 黑名单列表friends/speciallist 特别收听列表friends/add 收听某个用户friends/del 取消收听某个用户friends/addspecial 特别收听某个用户friends/delspecial 取消特别收听某个用户friends/addblacklist 添加某个用户到黑名单friends/delblacklist 从黑名单中删除某个用户friends/check 检测是否我的听众或收听的人friends/user_fanslist 其他帐户听众列表friends/user_idollist 其他帐户收听的人列表friends/user_speciallist 其他帐户特别收听的人列表friends/fanslist_s 我的听众列表,简单信息(200个)friends/idollist_s 我的收听列表,简单信息(200个)friends/mutual_list 互听关系链列表friends/match_nick_tips 好友账号及昵称输入提示私信相关private/add 发私信private/del 删除一条私信private/recv 收件箱private/send 发件箱搜索相关search/user 搜索用户search/t 搜索微博search/userbytag 通过标签搜索用户热度,趋势trends/ht 话题热榜trends/t 转播热榜trends/famouslist 推荐名人列表数据更新相关info/update 查看数据更新条数数据收藏fav/addt 收藏一条微博fav/delt 取消收藏一条微博fav/list_t 收藏的微博列表fav/addht 订阅话题fav/delht 取消订阅话题fav/list_ht 获取已订阅话题列表话题相关ht/ids 根据话题名称查询话题idht/info 根据话题id获取话题相关信息标签相关tag/add 添加标签tag/del 删除标签名单list/list_followers 名单订阅成员列表信息list/myfollowlist 我订阅的名单信息list/create 创建名单list/delete 删除名单list/edit 修改名单list/get_list 查询我创建的名单list/check_user_in_list 筛选指定的用户是否在名单中list/list_attr 名单属性信息list/follow 订阅多个名单list/undo_follow 取消订阅多个名单list/add_to_list 收录指定用户到名单list/del_from_list 从名单中删除指定用户list/get_other_in_list 查询指定用户所在的所有listlist/listusers 查询名单成员列表list/list_info 查询指定微博用户的名单相关信息微群相关weiqun/add 在微群中发表微博消息weiqun/apply4group 申请加入微群weiqun/bindqqgroup 微群与Q群互绑定weiqun/del 删除微群中的微博weiqun/home_timeline 微群主页时间线weiqun/multihome_timeline 多微群主页时间线weiqun/quitgroup 退出微群weiqun/setbulletin 设置微群公告weiqun/setmemattr 设置微群成员属性邀请相关invite/get_invite_list 获取好友列表invite/event_invite 发送好友邀请LBS相关LBS相关接口使用说明文档lbs/update_pos 更新地理位置lbs/del_pos 删除最后更新位置lbs/get_poi 获取POI(Point of Interest)lbs/get_around_new 获取身边最新的微博lbs/get_around_people 获取身边的人其他other/kownperson 我可能认识的人other/shorturl 短url变长urlother/videokey 获取视频上传的keyother/get_emotions 获取表情接口other/gettopreadd 一键转播热门排行other/follower_trans_conv 拉取我收听的用户的转播消息接口other/quality_trans_conv 拉取精华转播消息接口other/vip_trans_conv 拉取vip用户的转播消息接口other/url_converge 短url聚合other/gettopiczbrank 同话题热门转播排行文档更新历史API问题QA错误码说明表情列表下载取自“/index.php/API%E6%96%87%E6%A1%A3”帐户相关/取消收听某个用户返回出自腾讯微博开放平台跳转到:导航, 搜索目录[隐藏]∙ 1 请求说明∙ 2 参数说明∙ 3 使用说明∙ 4 返回结果∙ 5 字段说明请求说明url /api/friends/del格式xml,jsonhttp请求方式post是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明参数说明请求参数:oauth或openid&openkey标准参数,并带上以下参数format 返回数据的格式(json或xml)name 他人的帐户名(可选)他人的openid(可选)fopenidname和fopenid至少选一个,若同时存在则以name值为主使用说明/api/friends/delpost包体格式为:format=json&name=xxxx&fopenid=xxxx返回结果{ret:0,msg:"ok",errcode:0}字段说明ret: 返回值,0-成功,非0-失败msg:错误信息errcode:返回错误码errcode:发表失败错误码参看文档最后说明,点击此处查看取自“/index.php/%E5%B8%90%E6%88%B7%E7%9B%B8%E5%85%B3/%E5 %8F%96%E6%B6%88%E6%94%B6%E5%90%AC%E6%9F%90%E4%B8%AA%E7%94%A8%E6%88%B 7”。

api接口说明文档模板文

api接口说明文档模板文

api接口说明文档模板文API是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件的以访问一组例程的能力今天小编给大家整理了api知识供大家参考,我们一起来看看吧!api接口说明文档模板1API:应用程序接口(API:Application Program Interface)应用程序接口是一组定义、程序及协议的集合,通过API 接口实现计算机软件之间的相互通信。

API 的一个主要功能是提供通用功能集。

程序员通过调用API 函数对应用程序进行开发,可以减轻编程任务。

API 同时也是一种中间件,为各种不同平台提供数据共享。

根据单个或分布式平台上不同软件应用程序间的数据共享性能,可以将 API 分为四种类型:远程过程调用(RPC):通过作用在共享数据缓存器上的过程(或任务)实现程序间的通信。

标准查询语言(SQL):是标准的访问数据的查询语言,通过数据库实现应用程序间的数据共享。

文件传输:文件传输通过发送格式化文件实现应用程序间数据共享。

信息交付:指松耦合或紧耦合应用程序间的小型格式化信息,通过程序间的直接通信实现数据共享。

当前应用于 API 的标准包括 ANSI 标准 SQL API。

另外还有一些应用于其它类型的标准尚在制定之中。

API 可以应用于所有计算机平台和操作系统。

这些 API 以不同的格式连接数据(如共享数据缓存器、数据库结构、文件框架)。

每种数据格式要求以不同的数据命令和参数实现正确的数据通信,但同时也会产生不同类型的错误。

因此,除了具备执行数据共享任务所需的知识以外,这些类型的API 还必须解决很多网络参数问题和可能的差错条件,即每个应用程序都必须清楚自身是否有强大的性能支持程序间通信。

相反由于这种API 只处理一种信息格式,所以该情形下的信息交付API 只提供较小的命令、网络参数以及差错条件子集。

正因为如此,交付API 方式大大降低了系统复杂性,所以当应用程序需要通过多个平台实现数据共享时,采用信息交付 API 类型是比较理想的选择。

Leanpub API接口文档说明书

Leanpub API接口文档说明书

Package‘leanpubr’October13,2022Version0.3.1Title'Leanpub'API InterfaceDescription Provides access to the'Leanpub'API<https:///help/api>for gathering information aboutpublications and submissions to the'Leanpub'platform.License GPL-3Imports httr,xml2,jsonliteSuggests knitr,rmarkdown,covr,testthatEncoding UTF-8LazyData trueByteCompile trueType PackageMaintainer John Muschelli<*********************>VignetteBuilder knitrURL https:///muschellij2/leanpubrBugReports https:///muschellij2/leanpubr/issuesRoxygenNote6.1.0NeedsCompilation noAuthor John Muschelli[aut,cre]Repository CRANDate/Publication2018-08-1609:30:05UTCR topics documented:lp_api_key (2)lp_base_url (3)lp_book_info (3)lp_coupons (4)lp_download (5)12lp_api_keylp_get_wrapper (6)lp_job_status (7)lp_links (7)lp_preview (8)lp_publish (9)lp_sales (10)Index11 lp_api_key Find API Key for LeanpubDescriptionDetermines if Leanpub API Key is set.If not,it stops and returns an error.If so,returns the value.Usagelp_api_key(api_key=NULL,error=TRUE)lp_have_api_key(api_key=NULL)Argumentsapi_key Leanpub API key(Sys.getenv( LEANPUB_API_KEY ))error Should the function error if api_key=NULL?ValueCharacter API keyNoteYou can either set the API key or have it accessible by api_key=Sys.getenv( LEANPUB_API_KEY ).Examplesres=lp_api_key(error=FALSE)lp_have_api_key()lp_base_url3 lp_base_url Leanpub Base URLDescriptionLeanpub Base URLUsagelp_base_url(secure=TRUE)Argumentssecure Should https be used(may be necessary)ValueCharacter vector(length1)of URLExampleslp_base_url()lp_book_info Leanpub Book InformationDescriptionLeanpub Book InformationUsagelp_book_info(slug,api_key=NULL,secure=TRUE,verbose=TRUE,...)lp_summary(slug,api_key=NULL,secure=TRUE,verbose=TRUE,...) Argumentsslug slug of the projectapi_key API key for Leanpub,passed to lp_api_keysecure passed to lp_base_url for httpsverbose print diagnostic messages...additional options to pass to GET4lp_coupons ValueList of the result of the GET call and the contentNoteSee https:///help/apiExamplesif(lp_have_api_key()){stat=lp_book_info(slug="modernscientist")}lp_coupons Leanpub CouponsDescriptionLeanpub CouponsUsagelp_coupons(slug,api_key=NULL,secure=TRUE,verbose=TRUE,...) Argumentsslug slug of the projectapi_key API key for Leanpub,passed to lp_api_keysecure passed to lp_base_url for httpsverbose print diagnostic messages...additional options to pass to GETValueList of the result of the GET call and the contentNoteSee https:///help/apilp_download5 lp_download Leanpub Download Latest VersionDescriptionLeanpub Download Latest VersionUsagelp_download(slug,format=c("pdf","mobi","epub"),api_key=NULL,secure=TRUE,verbose=TRUE,...)Argumentsslug slug of the projectformat format of the book to downloadapi_key API key for Leanpub,passed to lp_api_keysecure passed to lp_base_url for httpsverbose print diagnostic messages...additional options to pass to GETValueList of the result of the GET call and the contentNoteSee https:///help/apiExamplesif(lp_have_api_key()){slug="biostatmethods"res=lp_download(slug,verbose=FALSE,nonstop=TRUE,error=FALSE,format="mobi")file.exists(res)}6lp_get_wrapper lp_get_wrapper Leanpub Wrapper for GET/POST statementsDescriptionLeanpub Wrapper for GET/POST statementsUsagelp_get_wrapper(slug,endpoint,api_key=NULL,secure=TRUE,verbose=TRUE,...)lp_post_wrapper(slug,endpoint,api_key=NULL,secure=TRUE,verbose=TRUE,...)Argumentsslug slug of the projectendpoint call to the api endpointapi_key API key for Leanpub,passed to lp_api_keysecure passed to lp_base_url for httpsverbose print diagnostic messages...additional options to pass to GETValueList of the result of the GET call and the contentNoteSee https:///help/apiExamplesif(lp_have_api_key()){stat=lp_get_wrapper(slug="neuroimagingforstatisticians",endpoint="/job_status",nonstop=TRUE,error=FALSE)}lp_job_status7 lp_job_status Leanpub Job StatusDescriptionLeanpub Job StatusUsagelp_job_status(slug,api_key=NULL,secure=TRUE,verbose=TRUE,...)Argumentsslug slug of the projectapi_key API key for Leanpub,passed to lp_api_keysecure passed to lp_base_url for httpsverbose print diagnostic messages...additional options to pass to GETValueList of the result of the GET call and the contentNoteSee https:///help/apiExamplesif(lp_have_api_key()){stat=lp_job_status(slug="neuroimagingforstatisticians",nonstop=TRUE,error=FALSE)}lp_links Leanpub LinksDescriptionLeanpub LinksUsagelp_links(slug,api_key=NULL,secure=TRUE,verbose=TRUE,...)8lp_previewArgumentsslug slug of the projectapi_key API key for Leanpub,passed to lp_api_keysecure passed to lp_base_url for httpsverbose print diagnostic messages...additional options to pass to GETValueList of URLsNoteSee https:///help/apiExamplesif(lp_have_api_key()){slug="biostatmethods"res=lp_links(slug,nonstop=TRUE,error=FALSE)}lp_preview Leanpub PreviewDescriptionLeanpub PreviewUsagelp_preview(slug,api_key=NULL,secure=TRUE,verbose=TRUE,...) Argumentsslug slug of the projectapi_key API key for Leanpub,passed to lp_api_keysecure passed to lp_base_url for httpsverbose print diagnostic messages...additional options to pass to GETValueList of the result of the GET call and the contentlp_publish9NoteSee https:///help/apiExamplesif(lp_have_api_key()){slug="neuroimagingforstatisticians"res=lp_preview(slug,nonstop=FALSE,error=FALSE)}lp_publish Leanpub PublishDescriptionLeanpub PublishUsagelp_publish(slug,api_key=NULL,secure=TRUE,verbose=TRUE,...) Argumentsslug slug of the projectapi_key API key for Leanpub,passed to lp_api_keysecure passed to lp_base_url for httpsverbose print diagnostic messages...additional options to pass to GETValueList of the result of the GET call and the contentNoteSee https:///help/apiExamplesif(lp_have_api_key()){slug="neuroimagingforstatisticians"res=lp_publish(slug,nonstop=TRUE,error=FALSE)}10lp_sales lp_sales Leanpub Sales InformationDescriptionLeanpub Sales InformationUsagelp_sales(slug,api_key=NULL,secure=TRUE,verbose=TRUE,...)lp_all_sales(slug,api_key=NULL,secure=TRUE,verbose=TRUE,...)Argumentsslug slug of the projectapi_key API key for Leanpub,passed to lp_api_keysecure passed to lp_base_url for httpsverbose print diagnostic messages...additional options to pass to GETValueList of the result of the GET call and the contentNoteSee https:///help/apiExamplesif(lp_have_api_key()){lp_all_sales(slug="biostatmethods",query=list(page=2))}IndexGET,3–10lp_all_sales(lp_sales),10lp_api_key,2,3–10lp_base_url,3,3,4–10lp_book_info,3lp_coupons,4lp_download,5lp_get_wrapper,6lp_have_api_key(lp_api_key),2lp_job_status,7lp_links,7lp_post_wrapper(lp_get_wrapper),6lp_preview,8lp_publish,9lp_sales,10lp_summary(lp_book_info),311。

开发接口文档API文档模板

开发接口文档API文档模板

版本控制信息版本日期描绘作者2018-8-13创立XXX获得全部字段1.1获得全部字段恳求地点:/session/field/findAll恳求参数参数名必填字段种类描绘name 是String 依据名称挑选响应code 10000成功,-1系统错误,10001必填参数为空message 响应描绘result 如响应例子恳求例子:响应例子:{"code":"10000","exception":null,"isSuccess":true,"message":"成功,系统办理正常!","page":0,"pageSize":0,"returnObject":null,"returnValue":{"types":null,"villages":nu ll,"companys":[{"iconColour":"","iconSize":0,"iconStyle":"","id":4,"name":"XX"},{"iconColour":"","iconSize": 0,"iconStyle":"","id":5,"name":"XX"},{"iconColour":"","iconSize":0,"iconStyle":"","id":7,"name":"XX"}]},"tot als":0}文件上传2.1文件上传(ajax)恳求地点:/session/file/upload恳求参数参数名必填字段种类描绘file 是FormData FormData对象包括的文件响应code 10000成功,-1系统错误,10001必填参数为空message 响应描绘result 如响应例子恳求例子:varformData=newFormData(); ("file",[0]);$.ajax({url:routePath+"/session/file/upload", type:'POST',data:formData,processData:false,contentType:false,success:function(result){result=(result);if=="10000"){ ('上传成功!');editHeadPortrait").val} }});响应例子:returnValue 里包括了fileName 和filePath字段管理-所属种类3.1新增所属种类恳求地点:/session/fieldType/save恳求参数参数名必填字段种类描绘name 是String 所属种类名称响应code 10000成功,-1系统错误,10001必填参数为空message 响应描绘result 如响应例子恳求例子:响应例子:{"code":"10000","exception":null,"isSuccess":true,"message":"成功,系统办理正常!","page":0,"pageSize":0,"returnListSize":0,"returnObject":null,"returnValue":null,"to tals":0}3.2改正所属种类恳求地点:/session/fieldType/update恳求参数参数名必填字段种类描绘id 是Long 所属种类idname 是String 所属种类名称响应code 10000成功,-1系统错误,10001必填参数为空message 响应描绘result 如响应例子恳求例子:&name=test响应例子:{"code":"10000","exception":null,"isSuccess":true,"message":" 成功,系统办理正常!","page":0,"pageSize":0,"returnListSize":0,"returnObject":null,"returnValue":null,"to tals":0}3.3依据id获得所属种类恳求地点:/session/fieldType/getById恳求参数参数名必填字段种类描绘id 是Long 所属种类id响应code 10000成功,-1系统错误,10001必填参数为空message 响应描绘result 如响应例子恳求例子:响应例子:{"code":"10000","exception":null,"isSuccess":true,"message":"成功,系统办理正常!","page":0,"pageSize":0,"returnListSize":0,"returnObject":null,"returnValue":{"id":2, "name":"re"},"totals":0}3.4获得所属种类列表恳求地点:/session/fieldType/selectAll恳求参数参数名必填字段种类描绘name 否String 依据种类名称挑选响应code 10000成功,-1系统错误,10001必填参数为空message 响应描绘result 如响应例子恳求例子:响应例子:{"code":"10000","exception":null,"isSuccess":true,"message":"成功,系统办理正常!","page":0,"pageSize":0,"returnObject":null,"returnValue":[{"id":1,"name":"123"},{"id ":6,"name":"145555"}],"totals":2}3.5删除所属种类(批量)恳求地点:/session/fieldType/deleteByIds恳求参数参数名必填字段种类描绘ids 是List 所属种类id会合响应code 10000成功,-1系统错误,10001必填参数为空message 响应描绘result 如响应例子恳求例子:响应例子:{"code":"10000","exception":null,"isSuccess":true,"message":"成功,系统办理正常!","page":0,"pageSize":0,"returnListSize":0,"returnObject":null,"returnValue":null,"t otals":0}。

汉印云打印 开放API 接口文档 使用说明书

汉印云打印 开放API 接口文档 使用说明书

【汉印云打印】开放API接口文档版本(1.1)2018年10月汉印云打印平台.接口文档V1.1目录1.概述: (1)2.打印接口: (1)2.1API接口地址 (1)2.2API请求方式 (1)2.3API调用方法 (1)2.4系统级和应用级的参数 (2)2.5签名加密算法如下: (3)2.6加密示例: (3)2.7需要传递给API的参数是: (3)3.APP调用功能: (4)3.1添加打印机 (4)3.2删除打印机 (5)3.3打印订单 (6)3.4查询打印机状态 (7)3.5查询打印完成情况 (8)4.内容排版标记参数 (10)5.注意事项 (13)6.版本信息: (14)1.概述:汉印云打印平台是以互联网为基础,整合云打印机资源,构建漫游共享的打印平台,向所有用户提供随时随地高质量、标准化的打印服务,包含了云平台、API、云打印服务器、云打印机等,产品广泛应用于快递业、超市、餐饮、社区店、生鲜店等,并致力于成为国内一线互联网云平台。

本文档提供了面向互联网开放的API接口,可有效的实现汉印云打印平台和应用开发者之间的对接,帮助用户和开发者方便地使用云平台的架构和功能。

2.打印接口:本节介绍如何发送数据到汉印云API并通过云平台输出打印指令,以及对应的状态返回码。

2.1API接口地址/api/values2.2API请求方式POST2.3API调用方法发送打印数据到汉印云API请求以及参数应该用POST方法发送。

汉印云API将根据收到的信息验证请求的有效性反馈对应的状态码。

2.4系统级和应用级的参数发送打印数据到汉印云请求必须包含以下参数(系统级参数和应用级参数)。

系统级参数应用级参数2.5签名加密算法如下:Sign=MD5(UserID+PrinterNo+TimeStamp+ApiKey),串在一起后进行MD5加密然后再转成大写,括号里面的参数只需要传入值。

2.6加密示例:000001hcs100171600521498469357ED93DC463FA44A7F8BD1919AE282C 310这是未加密前串在一起的排列,然后把这串字符进行MD5加密得到的结果就是sign的值Sign=MD5(UserID+PrinterNo+TimeStamp+ApiKey)2.7需要传递给API的参数是:UserID、PrinterNo、TimeStamp这3个参数是需要提交给API的。

电商管理后台API接口文档

电商管理后台API接口文档

电商管理后台API接⼝⽂档1. 电商管理后台 API 接⼝⽂档1.1. API V1 接⼝说明接⼝基准地址:http://127.0.0.1:8888/api/private/v1/服务端已开启 CORS 跨域⽀持API V1 认证统⼀使⽤ Token 认证需要授权的 API ,必须在请求头中使⽤ Authorization 字段提供 token 令牌使⽤ HTTP Status Code 标识状态数据返回格式统⼀使⽤ JSON1.1.1. ⽀持的请求⽅法GET(SELECT):从服务器取出资源(⼀项或多项)。

POST(CREATE):在服务器新建⼀个资源。

PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。

PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性)。

DELETE(DELETE):从服务器删除资源。

HEAD:获取资源的元数据。

OPTIONS:获取信息,关于资源的哪些属性是客户端可以改变的。

1.1.2. 通⽤返回状态说明状态码含义说明200OK请求成功201CREATED创建成功204DELETED删除成功400BAD REQUEST请求的地址不存在或者包含不⽀持的参数401UNAUTHORIZED未授权403FORBIDDEN被禁⽌访问404NOT FOUND请求的资源不存在422Unprocesable entity[POST/PUT/PATCH] 当创建⼀个对象时,发⽣⼀个验证错误500INTERNAL SERVER ERROR内部错误1.2. 登录1.2.1. 登录验证接⼝请求路径:login请求⽅法:post请求参数参数名参数说明备注username⽤户名不能为空password密码不能为空响应参数参数名参数说明备注id⽤户 IDrid⽤户⾓⾊ IDusername⽤户名mobile⼿机号email邮箱token令牌基于 jwt 的令牌响应数据{"data": {"id": 500,"rid": 0,"username": "admin","mobile": "123","email": "123@","token": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOjUwMCwicmlkIjowLCJpYXQiOjE1MTI1NDQyOTksImV4cCI6MTUxMjYzMDY5OX0.eGrsrvwHm-tPsO9r_pxHIQ5i5L1kX9RX444uwnRGaIM"},"meta": {"msg": "登录成功","status": 200}}1.3. ⽤户管理1.3.1. ⽤户数据列表请求路径:users请求⽅法:get请求参数参数名参数说明备注query查询参数可以为空pagenum当前页码不能为空pagesize每页显⽰条数不能为空响应参数参数名参数说明备注totalpage总记录数pagenum当前页码users⽤户数据集合响应数据{"data": {"totalpage": 5,"pagenum": 4,"users": [{"id": 25,"username": "tige117","mobile": "186********","type": 1,"email": "tige112@","create_time": "2017-11-09T20:36:26.000Z","mg_state": true, // 当前⽤户的状态"role_name": "炒鸡管理员"}]},"meta": {"msg": "获取成功","status": 200}}1.3.2. 添加⽤户请求路径:users请求⽅法:post请求参数参数名参数说明备注username⽤户名称不能为空password⽤户密码不能为空email邮箱可以为空mobile⼿机号可以为空响应参数参数名参数说明备注id⽤户 IDrid⽤户⾓⾊ IDusername⽤户名mobile⼿机号email邮箱响应数据{"data": {"id": 28,"username": "tige1200","mobile": "test","type": 1,"openid": "","email": "test@","create_time": "2017-11-10T03:47:13.533Z","modify_time": null,"is_delete": false,"is_active": false},"meta": {"msg": "⽤户创建成功","status": 201}}1.3.3. 修改⽤户状态请求路径:users/:uId/state/:type请求⽅法:put请求参数参数名参数说明备注uId⽤户 ID不能为空携带在url中type⽤户状态不能为空携带在url中,值为 true 或者 false 响应数据{"data": {"id": 566,"rid": 30,"username": "admin","mobile": "123456","email": "bb@","mg_state": 0},"meta": {"msg": "设置状态成功","status": 200}}1.3.4. 根据 ID 查询⽤户信息请求路径:users/:id请求⽅法:get请求参数参数名参数说明备注id⽤户 ID不能为空携带在url中响应参数参数名参数说明备注id⽤户 IDrole_id⾓⾊ IDmobile⼿机号email邮箱响应数据{"data": {"id": 503,"username": "admin3","role_id": 0,"mobile": "00000","email": "new@"},"meta": {"msg": "查询成功","status": 200}}1.3.5. 编辑⽤户提交请求路径:users/:id请求⽅法:put请求参数参数名参数说明备注id⽤户 id不能为空参数是url参数:idemail邮箱可以为空mobile⼿机号可以为空响应参数参数名参数说明备注id⽤户 IDrole_id⾓⾊ IDmobile⼿机号email邮箱响应数据/* 200表⽰成功,500表⽰失败 */{"data": {"id": 503,"username": "admin3","role_id": 0,"mobile": "111","email": "123@"},"meta": {"msg": "更新成功","status": 200}}1.3.6. 删除单个⽤户请求路径:users/:id请求⽅法:delete请求参数参数名参数说明备注id⽤户 id不能为空参数是url参数:id响应参数响应数据{"data": null,"meta": {"msg": "删除成功","status": 200}}1.3.7. 分配⽤户⾓⾊请求路径:users/:id/role请求⽅法:put请求参数参数名参数说明备注id⽤户 ID不能为空参数是url参数:idrid⾓⾊ id不能为空参数body参数响应参数参数名参数说明备注id⽤户 IDrole_id⾓⾊ IDmobile⼿机号email邮箱响应数据{"data": {"id": 508,"rid": "30","username": "asdf1","mobile": "123123","email": "adfsa@"},"meta": {"msg": "设置⾓⾊成功","status": 200}}1.4. 权限管理1.4.1. 所有权限列表请求路径:rights/:type请求⽅法:get参数名参数说明备注type类型值 list 或 tree , list 列表显⽰权限, tree 树状显⽰权限,参数是url参数:type 响应参数参数名参数说明备注id权限 IDauthName权限说明level权限层级pid权限⽗ IDpath对应访问路径响应数据 type=list{"data": [{"id": 101,"authName": "商品管理","level": "0","pid": 0,"path": null},{"id": 102,"authName": "订单管理","level": "0","pid": 0,"path": null}],"meta": {"msg": "获取权限列表成功","status": 200}}type=tree{data: [{id: 101,authName: '商品管理',path: null,pid: 0,children: [{id: 104,authName: '商品列表',path: null,pid: 101,children: [{id: 105,authName: '添加商品',path: null,pid: '104,101'}]}]}],meta: {msg: '获取权限列表成功',status: 200}}1.4.2. 左侧菜单权限请求路径:menus请求⽅法:get响应数据{"data":{"id": 101,"authName": "商品管理","path": null,"children": [{"id": 104,"authName": "商品列表","path": null,"children": []}]}"meta": {"msg": "获取菜单列表成功","status": 200}}1.5. ⾓⾊管理1.5.1. ⾓⾊列表请求路径:roles请求⽅法:get响应数据说明第⼀层为⾓⾊信息第⼆层开始为权限说明,权限⼀共有 3 层权限最后⼀层权限,不包含 children 属性响应数据{"data": [{"id": 30,"roleName": "主管","roleDesc": "技术负责⼈","children": [{"id": 101,"authName": "商品管理","path": null,"children": ["id": 104,"authName": "商品列表","path": null,"children": [{"id": 105,"authName": "添加商品","path": null}]}]}]}],"meta": {"msg": "获取成功","status": 200}}1.5.2. 添加⾓⾊请求路径:roles请求⽅法:post请求参数参数名参数说明备注roleName⾓⾊名称不能为空roleDesc⾓⾊描述可以为空响应参数参数名参数说明备注roleId⾓⾊ IDroleName⾓⾊名称roleDesc⾓⾊描述响应数据{"data": {"roleId": 40,"roleName": "admin2","roleDesc": "admin2Desc"},"meta": {"msg": "创建成功","status": 201}}1.5.3. 根据 ID 查询⾓⾊请求路径:roles/:id请求⽅法:get请求参数参数名参数说明备注:id⾓⾊ ID不能为空携带在url中响应参数参数名参数说明备注roleId⾓⾊ IDroleName⾓⾊名称roleDesc⾓⾊描述响应数据{"data": {"roleId": 31,"roleName": "测试⾓⾊","roleDesc": "测试负责⼈"},"meta": {"msg": "获取成功","status": 200}}1.5.4. 编辑提交⾓⾊请求路径:roles/:id请求⽅法:put请求参数参数名参数说明备注:id⾓⾊ ID不能为空携带在url中roleName⾓⾊名称不能为空roleDesc⾓⾊描述可以为空响应数据{"data": {"roleId": 31,"roleName": "测试⾓⾊","roleDesc": "测试⾓⾊描述"},"meta": {"msg": "获取成功","status": 200}}1.5.5. 删除⾓⾊请求路径:roles/:id请求⽅法:delete请求参数响应数据{"data": null, "meta": {"msg": "删除成功", "status": 200 }}1.5.6. ⾓⾊授权请求路径:roles/:roleId/rights 请求⽅法:post请求参数:通过 请求体 发送给后端响应数据{"data": null, "meta": {"msg": "更新成功", "status": 200 }}1.5.7. 删除⾓⾊指定权限请求路径:roles/:roleId/rights/:rightId 请求⽅法:delete 请求参数响应数据说明返回的data, 是当前⾓⾊下最新的权限数据响应数据{"data": [ {"id": 101,"authName": "商品管理", "path": null, "children": [ {"id": 104,"authName": "商品列表", "path": null, "children": [ {"id": 105,"authName": "添加商品", "path": null }, {"id": 116,"authName": "修改", "path": null } ] } ] } ],"meta": {"msg": "取消权限成功", "status": 200 }}1.6. 商品分类管理1.6.1. 商品分类数据列表请求路径:categories 请求⽅法:get 请求参数响应参数响应数据{"data": [ {"cat_id": 1,"cat_name": "⼤家电", "cat_pid": 0, "cat_level": 0,"cat_deleted": false, "children": [ {"cat_id": 3,"cat_name": "电视",参数名参数说明备注:id⾓⾊ ID不能为空携带在url 中参数名参数说明备注:roleId ⾓⾊ ID不能为空携带在url 中rids权限 ID 列表(字符串)以 , 分割的权限 ID 列表(获取所有被选中、叶⼦节点的key 和半选中节点的key, 包括 1,2,3级节点)参数名参数说明备注:roleId ⾓⾊ ID 不能为空携带在url 中:rightId权限 ID不能为空携带在url 中参数名参数说明备注type [1,2,3]值:1,2,3 分别表⽰显⽰⼀层⼆层三层分类列表【可选参数】如果不传递,则默认获取所有级别的分类pagenum 当前页码值【可选参数】如果不传递,则默认获取所有分类pagesize每页显⽰多少条数据【可选参数】如果不传递,则默认获取所有分类参数名参数说明备注cat_id 分类 ID cat_name 分类名称cat_pid 分类⽗ ID cat_level分类当前层级"cat_pid": 1,"cat_level": 1,"cat_deleted": false,"children": [{"cat_id": 6,"cat_name": "曲⾯电视","cat_pid": 3,"cat_level": 2,"cat_deleted": false},{"cat_id": 7,"cat_name": "海信","cat_pid": 3,"cat_level": 2,"cat_deleted": false}]}]}],"meta": {"msg": "获取成功","status": 200}}1.6.2. 添加分类请求路径:categories请求⽅法:post请求参数参数名参数说明备注cat_pid分类⽗ ID不能为空,如果要添加1级分类,则⽗分类Id应该设置为 0 cat_name分类名称不能为空cat_level分类层级不能为空,0表⽰⼀级分类;1表⽰⼆级分类;2表⽰三级分类响应数据{"data": {"cat_id": 62,"cat_name": "相框","cat_pid": "1","cat_level": "1"},"meta": {"msg": "创建成功","status": 201}}1.6.3. 根据 id 查询分类请求路径:categories/:id请求⽅法:get请求参数参数名参数说明备注:id分类 ID不能为空携带在url中响应数据{"data": {"cat_id": 3,"cat_name": "厨卫电器","cat_pid": 0,"cat_level": 0},"meta": {"msg": "获取成功","status": 200}}1.6.4. 编辑提交分类请求路径:categories/:id请求⽅法:put请求参数参数名参数说明备注:id分类 ID不能为空携带在url中cat_name分类名称不能为空【此参数,放到请求体中】响应数据{"data": {"cat_id": 22,"cat_name": "⾃拍杆","cat_pid": 7,"cat_level": 2},"meta": {"msg": "更新成功","status": 200}}1.6.5. 删除分类请求路径:categories/:id请求⽅法:delete请求参数参数名参数说明备注:id分类 ID不能为空携带在url中响应数据{"data": null,"meta": {"msg": "删除成功","status": 200}}1.7. 分类参数管理1.7.1. 参数列表请求路径:categories/:id/attributes请求⽅法:get请求参数参数名参数说明备注:id分类 ID不能为空携带在url中sel[only,many]不能为空,通过 only 或 many 来获取分类静态参数还是动态参数响应参数参数名参数说明备注attr_id分类参数 IDattr_name分类参数名称cat_id分类参数所属分类attr_sel only:输⼊框(唯⼀) many:后台下拉列表/前台单选框attr_write manual:⼿⼯录⼊ list:从列表选择attr_vals如果 attr_write:list,那么有值,该值以逗号分隔响应数据{"data": [{"attr_id": 1,"attr_name": "cpu","cat_id": 22,"attr_sel": "only","attr_write": "manual","attr_vals": "ffff"}],"meta": {"msg": "获取成功","status": 200}}1.7.2. 添加动态参数或者静态属性请求路径:categories/:id/attributes请求⽅法:post请求参数参数名参数说明备注:id分类 ID不能为空携带在url中attr_name参数名称不能为空attr_sel[only,many]不能为空attr_vals如果是 many 就需要填写值的选项,以逗号分隔【可选参数】响应数据{"data": {"attr_id": 44,"attr_name": "测试参数","cat_id": "1","attr_sel": "many","attr_write": "list","attr_vals": "a,b,c"},"meta": {"msg": "创建成功","status": 201}}1.7.3. 删除参数请求路径: categories/:id/attributes/:attrid请求⽅法:delete请求参数参数名参数说明备注:id分类 ID不能为空携带在url中:attrid参数 ID不能为空携带在url中响应数据{"data": null,"meta": {"msg": "删除成功","status": 200}}1.7.4. 根据 ID 查询参数请求路径:categories/:id/attributes/:attrId请求⽅法:get请求参数参数名参数说明备注:id分类 ID不能为空携带在url中:attrId属性 ID不能为空携带在url中attr_sel[only,many]不能为空attr_vals如果是 many 就需要填写值的选项,以逗号分隔响应数据{"data": {"attr_name": "cpu","cat_id": 22,"attr_sel": "only","attr_write": "manual","attr_vals": "ffff"},"meta": {"msg": "获取成功","status": 200}}1.7.5. 编辑提交参数请求路径:categories/:id/attributes/:attrId请求⽅法:put请求参数参数名参数说明备注:id分类 ID不能为空携带在url中:attrId属性 ID不能为空携带在url中attr_name新属性的名字不能为空,携带在请求体中attr_sel属性的类型[many或only]不能为空,携带在请求体中attr_vals参数的属性值可选参数,携带在请求体中响应数据{"data": {"attr_id": 9,"attr_name": "测试更新","cat_id": "43","attr_sel": "only","attr_write": "manual","attr_vals": "abc"},"meta": {"msg": "更新成功","status": 200}}1.8. 商品管理1.8.1. 商品列表数据请求路径:goods请求⽅法:get请求参数参数名参数说明备注query查询参数可以为空pagenum当前页码不能为空pagesize每页显⽰条数不能为空响应参数参数名参数说明备注total总共商品条数pagenum当前商品页数goods_id商品 IDgoods_name商品名称goods_price价格goods_number数量goods_weight重量不能为空goods_state商品状态商品状态 0: 未通过 1: 审核中 2: 已审核add_time添加时间upd_time更新时间hot_mumber热销品数量is_promote是否是热销品响应数据{"data": {"total": 50,"pagenum": "1","goods": [{"goods_id": 144,"goods_name": "asfdsd","goods_price": 1,"goods_number": 1,"goods_weight": 1,"goods_state": null,"add_time": 1512954923,"upd_time": 1512954923,"hot_mumber": 0,"is_promote": false}]},"meta": {"msg": "获取成功","status": 200}}1.8.2. 添加商品请求路径:goods请求参数参数名参数说明备注goods_name商品名称不能为空goods_cat以为','分割的分类列表不能为空goods_price价格不能为空goods_number数量不能为空goods_weight重量不能为空goods_introduce介绍可以为空pics上传的图⽚临时路径(对象)可以为空attrs商品的参数(数组),包含动态参数和静态属性可以为空请求数据{"goods_name":"test_goods_name2","goods_cat": "1,2,3","goods_price":20,"goods_number":30,"goods_weight":40,"goods_introduce":"abc","pics":[{"pic":"/tmp_uploads/30f08d52c551ecb447277eae232304b8"}],"attrs":[{"attr_id":15,"attr_value":"ddd"},{"attr_id":15,"attr_value":"eee"}]}响应参数参数名参数说明备注total总共商品条数pagenum当前商品页数goods_id商品 IDgoods_cat以为','分割的分类列表goods_name商品名称goods_price价格goods_number数量goods_weight重量不能为空goods_state商品状态商品状态 0: 未通过 1: 审核中 2: 已审核add_time添加时间upd_time更新时间hot_mumber热销品数量is_promote是否是热销品pics上传的图⽚临时路径(对象)pics_id:图⽚ ID,goods_id:商品 ID,pics_big:⼤图,pics_mid:中图,pics_sma:⼩图attrs商品的参数(数组)goods_id:商品 ID,attr_value:当前商品的参数值,add_price:浮动价格,attr_vals:预定义的参数值,attr_sel:⼿动输⼊,还是单选,响应数据{"data": {"goods_id": 145,"goods_name": "test_goods_name2","goods_price": 20,"cat_id": 1,"goods_number": 30,"goods_weight": 40,"goods_introduce": "abc","goods_big_logo": "","goods_small_logo": "","goods_state": 1,"add_time": 1512962370,"upd_time": 1512962370,"hot_mumber": 0,"is_promote": false,"pics": [{"pics_id": 397,"goods_id": 145,"pics_big": "uploads/goodspics/big_30f08d52c551ecb447277eae232304b8","pics_mid": "uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8","pics_sma": "uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8"}],"attrs": [{"goods_id": 145,"attr_id": 15,"attr_value": "ddd","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""},{"goods_id": 145,"attr_id": 15,"attr_value": "eee","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""}]},"meta": {"msg": "创建商品成功","status": 201}}1.8.3. 根据 ID 查询商品请求路径:goods/:id请求⽅法:get请求参数参数名参数说明备注id商品 ID不能为空携带在url中响应参数参数名参数说明备注total总共商品条数pagenum当前商品页数goods_id商品 IDgoods_name商品名称goods_price价格goods_number数量goods_weight重量不能为空goods_state商品状态商品状态 0: 未通过 1: 审核中 2: 已审核add_time添加时间upd_time更新时间hot_mumber热销品数量is_promote是否是热销品pics上传的图⽚临时路径(对象)pics_id:图⽚ ID,goods_id:商品 ID,pics_big:⼤图,pics_mid:中图,pics_sma:⼩图attrs商品的参数(数组)goods_id:商品 ID,attr_value:当前商品的参数值,add_price:浮动价格,attr_vals:预定义的参数值,attr_sel:⼿动输⼊,还是单选,响应数据{"data": {"goods_id": 145,"goods_name": "test_goods_name2","goods_price": 20,"goods_number": 30,"goods_weight": 40,"goods_introduce": "abc","goods_big_logo": "","goods_small_logo": "","goods_state": 1,"add_time": 1512962370,"upd_time": 1512962370,"hot_mumber": 0,"is_promote": false,"pics": [{"pics_id": 397,"goods_id": 145,"pics_big": "uploads/goodspics/big_30f08d52c551ecb447277eae232304b8","pics_mid": "uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8","pics_sma": "uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8"}],"attrs": [{"goods_id": 145,"attr_id": 15,"attr_value": "ddd","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""},{"goods_id": 145,"attr_id": 15,"attr_value": "eee","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""}]},"meta": {"msg": "创建商品成功","status": 201}}1.8.4. 编辑提交商品请求路径:goods/:id请求⽅法:put请求参数参数名参数说明备注id商品 ID不能为空携带在url中goods_name商品名称不能为空goods_price价格不能为空goods_number数量不能为空goods_weight重量不能为空goods_introduce介绍可以为空pics上传的图⽚临时路径(对象)可以为空attrs商品的参数(数组)可以为空请求数据{"goods_name":"test_goods_name2","goods_price":20,"goods_number":30,"goods_weight":40,"goods_introduce":"abc","pics":[{"pic":"/tmp_uploads/30f08d52c551ecb447277eae232304b8"}],"attrs":[{"attr_id":15,"attr_value":"ddd"},{"attr_id":15,"attr_value":"eee"}]}响应参数参数名参数说明备注total总共商品条数pagenum当前商品页数goods_id商品 IDgoods_name商品名称goods_price价格goods_number数量goods_weight重量不能为空goods_state商品状态商品状态 0: 未通过 1: 审核中 2: 已审核add_time添加时间upd_time更新时间hot_mumber热销品数量is_promote是否是热销品pics上传的图⽚临时路径(对象)pics_id:图⽚ ID,goods_id:商品 ID,pics_big:⼤图,pics_mid:中图,pics_sma:⼩图attrs商品的参数(数组)goods_id:商品 ID,attr_value:当前商品的参数值,add_price:浮动价格,attr_vals:预定义的参数值,attr_sel:⼿动输⼊,还是单选,响应数据{"data": {"goods_id": 145,"goods_name": "test_goods_name2","goods_price": 20,"goods_number": 30,"goods_weight": 40,"goods_introduce": "abc","goods_big_logo": "","goods_small_logo": "","goods_state": 1,"add_time": 1512962370,"upd_time": 1512962370,"hot_mumber": 0,"is_promote": false,"pics": [{"pics_id": 397,"goods_id": 145,"pics_big": "uploads/goodspics/big_30f08d52c551ecb447277eae232304b8","pics_mid": "uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8","pics_sma": "uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8"}],"attrs": [{"goods_id": 145,"attr_id": 15,"attr_value": "ddd","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""},{"goods_id": 145,"attr_id": 15,"attr_value": "eee","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""}]},"meta": {"msg": "创建商品成功","status": 201}}1.8.5. 删除商品请求路径:goods/:id请求⽅法:delete请求参数参数名参数说明备注id商品 ID不能为空携带在url中响应数据{"data": null,"meta": {"msg": "删除成功","status": 200}}###同步商品图⽚请求路径:goods/:id/pics请求⽅法:put请求参数参数名参数说明备注id商品 ID不能为空携带在url中pics商品图⽚集合如果有 pics_id 字段会保留该图⽚,如果没有 pics_id 但是有 pic 字段就会新⽣成图⽚数据请求数据;[{ pic: 'tmp_uploads/db28f6316835836e97653b5c75e418be.png' },{pics_id: 397,goods_id: 145,pics_big: 'uploads/goodspics/big_30f08d52c551ecb447277eae232304b8',pics_mid: 'uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8',pics_sma: 'uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8'}]响应数据{"data": {"goods_id": 96,"goods_name": "iphoneXX","goods_price": 2,"goods_number": 22,"goods_weight": 22,"goods_introduce": null,"goods_big_logo": "./uploads/goods/20171113/483a3b8e99e534ec3e4312dbbaee7c9d.jpg","goods_small_logo": "./uploads/goods/20171113/small_483a3b8e99e534ec3e4312dbbaee7c9d.jpg","goods_state": 0,"is_del": "1","add_time": 1510045904,"upd_time": 1512635159,"delete_time": 1512635159,"hot_mumber": 0,"is_promote": false,"pics": [{"pics_id": 383,"goods_id": 96,"pics_big": "uploads/goodspics/big_6f5750132abd3f5b2b93dd722fcde653.jpg","pics_mid": "uploads/goodspics/mid_6f5750132abd3f5b2b93dd722fcde653.jpg","pics_sma": "uploads/goodspics/sma_6f5750132abd3f5b2b93dd722fcde653.jpg"}],"attrs": [{"goods_id": 96,"attr_id": 15,"attr_value": "eee","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""},{"goods_id": 96,"attr_id": 15,"attr_value": "ddd","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""}]},"meta": {"msg": "更新成功","status": 200}}###同步商品属性请求路径:goods/:id/attributes请求⽅法:put请求参数参数名参数说明备注id商品 ID不能为空携带在url中请求数据;[{attr_id: 15,attr_value: 'ddd'},{attr_id: 15,attr_value: 'eee'}]{"data": {"goods_id": 96,"goods_name": "iphoneXX","goods_price": 2,"goods_number": 22,"goods_weight": 22,"goods_introduce": null,"goods_big_logo": "./uploads/goods/20171113/483a3b8e99e534ec3e4312dbbaee7c9d.jpg","goods_small_logo": "./uploads/goods/20171113/small_483a3b8e99e534ec3e4312dbbaee7c9d.jpg","goods_state": 0,"is_del": "1","add_time": 1510045904,"upd_time": 1512635159,"delete_time": 1512635159,"hot_mumber": 0,"is_promote": false,"pics": [{"pics_id": 383,"goods_id": 96,"pics_big": "uploads/goodspics/big_6f5750132abd3f5b2b93dd722fcde653.jpg","pics_mid": "uploads/goodspics/mid_6f5750132abd3f5b2b93dd722fcde653.jpg","pics_sma": "uploads/goodspics/sma_6f5750132abd3f5b2b93dd722fcde653.jpg"}],"attrs": [{"goods_id": 96,"attr_id": 15,"attr_value": "eee","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""},{"goods_id": 96,"attr_id": 15,"attr_value": "ddd","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""}]},"meta": {"msg": "更新成功","status": 200}}###商品图⽚处理必须安装 GraphicsMagicklinuxapt-get install GraphicsMagickMac OS Xbrew install GraphicsMagickWindows1.9. 图⽚上传请求路径:upload请求⽅法:post请求参数参数名参数说明备注file上传⽂件响应数据{"data": {"tmp_path": "tmp_uploads/ccfc5179a914e94506bcbb7377e8985f.png","url": "http://127.0.0.1:8888tmp_uploads/ccfc5179a914e94506bcbb7377e8985f.png"},"meta": {"msg": "上传成功","status": 200}}1.10. 订单管理1.10.1. 订单数据列表请求路径:orders请求⽅法:get请求参数参数名参数说明备注query查询参数可以为空pagenum当前页码不能为空pagesize每页显⽰条数不能为空user_id⽤户 ID可以为空pay_status⽀付状态可以为空is_send是否发货可以为空order_fapiao_title['个⼈','公司']可以为空order_fapiao_company公司名称可以为空order_fapiao_content发票内容可以为空consignee_addr发货地址可以为空响应数据{"data": {"total": 1,"pagenum": "1",。

CIMIS Web API接口接口文档说明书

CIMIS Web API接口接口文档说明书

Package‘cimir’October12,2022Title Interface to the CIMIS Web APIVersion0.4-1Description Connect to the California Irrigation ManagementInformation System(CIMIS)Web API.See the CIMIS main page<https://>and web API documentation<https://>for more information.License GPL(>=3)URL https:///mkoohafkan/cimirBugReports https:///mkoohafkan/cimir/issuesDepends R(>=3.4)Imports curl(>=4.3),glue(>=1.3),stringr(>=1.4),dplyr(>=0.8),tidyr(>=1.0),jsonlite(>=1.6),purrr(>=0.3),rlang(>=0.4)Encoding UTF-8LazyData trueSuggests knitr(>=1.21),rmarkdown(>=1.11)VignetteBuilder knitrRoxygenNote7.1.1NeedsCompilation noAuthor Michael Koohafkan[aut,cre]Maintainer Michael Koohafkan<***************************>Repository CRANDate/Publication2021-02-1722:40:03UTCR topics documented:cimir (2)cimis_compass_to_degrees (3)cimis_data (3)12cimir cimis_degrees_to_compass (5)cimis_flags (6)cimis_format_location (6)cimis_items (7)cimis_split_query (8)cimis_station (9)cimis_to_datetime (10)set_key (10)Index12 cimir cimir:Interface to CIMISDescriptionThis package provides an R interface to the California Irrigation Management Information System (CIMIS)Web API.In order to use this package,you will need to create a CIMIS account and requesta web services AppKey.Package optionscimir uses the following options()to configure behavior:•cimir.appkey:The CIMIS AppKey to use for queries.•cimir.timeout:The maximum time to wait for a response from the CIMIS Web API.Alternatively,the CIMIS App Key can be saved to an environment variable CIMIS_APPKEY.Author(s)Maintainer:Michael Koohafkan<***************************>See AlsoUseful links:•https:///mkoohafkan/cimir•Report bugs at https:///mkoohafkan/cimir/issuescimis_compass_to_degrees3cimis_compass_to_degreesCompass Direction To DegreesDescriptionConvert the Compass direction labels to degrees.Usagecimis_compass_to_degrees(x)Argumentsx A vector of compass directions,i.e.the data item labels"DayWindNnw","Day-WindSse",etc.Recognized directions are North-northeast(NNE),East-northeast(ENE),East-southeast(ESE),South-southeast(SSE),South-southwest(SSW),West-southwest(WSW),West-northwest(WNW),and North-northwest(NNW).ValueA numeric vector of degrees corresponding to the middle azimuth of the corresponding compassdirection.See Alsocimis_degrees_to_compass()Examplescimis_compass_to_degrees("day-wind-nne")cimis_compass_to_degrees(c("SSE","SSW","wsw","Wnw","nnw"))cimis_data Query CIMIS DataDescriptionQuery CIMIS data using the Web API.4cimis_dataUsagecimis_data(targets,start.date,end.date,items,measure.unit=c("E","M"),prioritize.SCS=TRUE)Argumentstargets geographies or weather stations of interest.This parameter may specify one or many stations,zip codes,coordinates,or street addresses;however,you are notallowed to mix values from different categories.This means the targets param-eter must contain only stations,only zip codes,only coordinates,or only streetaddresses.You will receive an error if you attempt to mix different categorytypes.The formats are accepted:•A comma delimited list of WSN station numbers•A comma delimited list of California zip codes•A semicolon delimited list of decimal-degree coordinates•A semicolon delimited list of street addressesstart.date Specifies the start date.The data format is"yyyy-mm-dd".end.date Specifies the end date.The data format is"yyyy-mm-dd".items specifies one or more comma-delimited data elements to include in your re-sponse.See data_items()for a complete list of possible data element values.Default:day-asce-eto,day-precip,day-sol-rad-avg,day-vap-pres-avg,day-air-tmp-max,day-air-tmp-min,day-air-tmp-avg,day-rel-hum-max,day-rel-hum-min,day-rel-hum-avg,day-dew-pnt,day-wind-spd-avg,day-wind-run,day-soil-tmp-avg.measure.unit The unit of measure may be either"E"for English units or"M"for metric units.The value of this parameter will affect data values in the response.For example,designating English units will result in temperature values being returned inFahrenheit rather than Celsius.prioritize.SCS This parameter is relevant only when the targets parameter contains zip code(s).If TRUE,the Spatial CIMIS System(SCS)will be used as the preferred dataprovider.ValueA tibble object.Examplesif(is_key_set()){cimis_data(targets=170,start.date=Sys.Date()-4,end.date=Sys.Date()-1)cimis_degrees_to_compass5 }cimis_degrees_to_compassDegrees to Compass DirectionDescriptionConvert decimal degrees to Compass direction.Usagecimis_degrees_to_compass(x)Argumentsx A vector of directions in decimal degrees.DetailsDegrees are labeled with their corresponding Primary InterCardinal compass direction,following the convention of the CIMIS daily wind data items.ValueA factor vector of compass directions.See Alsocimis_compass_to_degrees()Examplescimis_degrees_to_compass(c(30,83,120,140,190,240,300,330))cimis_degrees_to_compass(cimis_compass_to_degrees(c("NNE","ENE","ESE","SSE","SSW","WSW","WNW","NNW")))6cimis_format_location cimis_flags CIMIS Data FlagsDescriptionList CIMIS data quality controlflags.Usagecimis_flags(type=c("Severe","Informative"),period="Current")Argumentstype The type of dataflag,i.e."Severe"or"Informative".period The Time period that data was collected,i.e.,"Current"or"Former"(pre-1995).Valuea dataframe of dataflags.See AlsoCIMIS Data Overview-Quality ControlExamplescimis_flags()cimis_flags("Informative")cimis_flags("Severe",period="Former")cimis_format_location Format CIMIS Station LocationDescriptionFormat the latitude and longitude of station in Decimal Degrees(DD)or Hour Minutes Seconds (HMS).Usagecimis_format_location(d,format=c("DD","HMS"))cimis_items7 Argumentsd A data frame of CIMIS data results.format The format to use,either Decimal Degrees("DD")or Hour Minutes Seconds ("HMS").ValueThe data frame,with a new"Latitude"and"Longitude"columns replacing the"HmsLatitude"and"HmsLongitude"columns.Examplesif(is_key_set()){d=cimis_station(170)cimis_format_location(d,"DD")cimis_format_location(d,"HMS")}cimis_items CIMIS Data ItemsDescriptionList CIMIS data items.Usagecimis_items(type=c("Daily","Hourly"))Argumentstype The type of data item,i.e."Daily"or"Hourly".Valuea dataframe of data items.Examplescimis_items()8cimis_split_query cimis_split_query Split CIMIS QueryDescriptionSplit a large CIMIS query into multiple smaller queries based on a time interval.Usagecimis_split_query(targets,start.date,end.date,items,max.records=1750L)Argumentstargets geographies or weather stations of interest.This parameter may specify one or many stations,zip codes,coordinates,or street addresses;however,you are notallowed to mix values from different categories.This means the targets param-eter must contain only stations,only zip codes,only coordinates,or only streetaddresses.You will receive an error if you attempt to mix different categorytypes.The formats are accepted:•A comma delimited list of WSN station numbers•A comma delimited list of California zip codes•A semicolon delimited list of decimal-degree coordinates•A semicolon delimited list of street addressesstart.date Specifies the start date.The data format is"yyyy-mm-dd".end.date Specifies the end date.The data format is"yyyy-mm-dd".items specifies one or more comma-delimited data elements to include in your re-sponse.See data_items()for a complete list of possible data element values.Default:day-asce-eto,day-precip,day-sol-rad-avg,day-vap-pres-avg,day-air-tmp-max,day-air-tmp-min,day-air-tmp-avg,day-rel-hum-max,day-rel-hum-min,day-rel-hum-avg,day-dew-pnt,day-wind-spd-avg,day-wind-run,day-soil-tmp-avg.max.records The maximum number of records returned by a query.The default value is the the maximum data limit allowed by the CIMIS Web API(1,750records). DetailsQueries are not split by targets or items,i.e.each resulting query will include all targets and items.ValueA data frame with columns"targets","start.date","end.date",and"items".cimis_station9 Examplescimis_split_query(170,"2000-01-01","2010-12-31","day-air-tmp-avg")cimis_split_query(c(149,170),"2018-01-01","2018-12-31",c("day-air-tmp-avg","hly-air-tmp","hly-rel-hum"))cimis_station Query CIMIS Station MetadataDescriptionQuery CIMIS station metadata.Usagecimis_station(station)cimis_spatial_zipcode(zipcode)cimis_zipcode(zipcode)Argumentsstation The station ID.If missing,metadata for all stations is returned.zipcode The(spatial)zip code.If missing,metadata for all stations is returned.ValueA tibble object.Examplesif(is_key_set()){cimis_station()cimis_zipcode()cimis_spatial_zipcode()}10set_key cimis_to_datetime To DatetimeDescriptionCollapse The Date and Hour columns to a single DateTime Column.Usagecimis_to_datetime(d)Argumentsd A data frame of CIMIS data results.DetailsAccording to the CIMIS Report FAQs,all CIMIS data is based on Pacific Standard Time(PST).ValueThe data frame,with a new"Datetime"column replacing the"Date"and"Hour"columns.Examplesif(is_key_set()){d=cimis_data(targets=170,start.date=Sys.Date()-4,end.date=Sys.Date()-1,items="hly-air-tmp")cimis_to_datetime(d)}set_key Specify CIMIS API keyDescriptionEnter your CIMIS AppKey for web API data access.Usageset_key(key=NULL)remove_key()is_key_set()set_key11Argumentskey A CIMIS AppKey.Examples##Not run:set_key("YOUR-APP-KEY")is_key_set()remove_key()##End(Not run)Indexcimir,2cimir-package(cimir),2cimis_compass_to_degrees,3cimis_compass_to_degrees(),5cimis_data,3cimis_degrees_to_compass,5cimis_degrees_to_compass(),3cimis_flags,6cimis_format_location,6cimis_items,7cimis_spatial_zipcode(cimis_station),9 cimis_split_query,8cimis_station,9cimis_to_datetime,10cimis_zipcode(cimis_station),9is_key_set(set_key),10options(),2remove_key(set_key),10set_key,1012。

4PX API接口参数说明文档

4PX API接口参数说明文档

4PX物流接口参数说明深圳递四方速递2012-06版本信息目录版本信息 (2)1.概述 (4)1.1.写作目的 (4)1.2.本文读者 (4)1.3.调用方式 (4)1.API 接口参数 (5)1.1.创建订单 (5)1.2.预报订单 (9)1.3.创建并预报订单 (11)1.4.修改订单 (15)1.5.删除订单 (19)1.6.查询订单 (21)1.7.运费试算 (25)1.8.查询轨迹 (28)1.9.申请拦截 (30)1.10.查询跟踪号 (32)1.概述1.1.写作目的本文档是4PX提供的物流接口参数说明,以供开发人员和测试人员参考。

1.2.本文读者本文主要读者为开发员和测试员。

1.3.调用方式1.3.1.W SDL在线订单操作Sandbox::8090/OrderOnline/ws/OrderOnlineService.dll?wsdl 在线订单工具Sandbox::8090/OrderOnlineTool/ws/OrderOnlineToolService.dl l?wsdl1.3.2.S DK4PX提供的SDK调用方式,封装了我司API接口。

1.3.3.测试环境网站URL : :8094/可以通过该网站看到测试环境API上传的订单情况.注:无论是WSDL或者SDK调用方式,如要上线,必需向我司申请正式WSDL或SDK。

1.API 接口参数1.1.创建订单类型: 在线订单操作接口名称:createOrderService1.1.1.请求参数1.1.2.返回参数1.2.预报订单类型: 在线订单操作接口名称:preAlertOrderService 1.2.1.请求参数1.2.2.返回参数1.3.创建并预报订单类型: 在线订单操作接口名称:createAndPreAlertOrderService 1.3.1.请求参数1.3.2.返回参数1.4.修改订单类型: 在线订单操作接口名称:modifyOrderService 1.4.1.请求参数1.4.2.返回参数1.5.删除订单类型: 在线订单操作接口名称:removeOrderService 1.5.1.请求参数1.5.2.返回参数1.6.查询订单类型: 在线订单操作接口名称:findOrderService 1.6.1.请求参数1.6.2.返回参数1.7.运费试算类型: 在线订单工具接口名称:chargeCalculateService1.7.1.请求参数1.7.2.返回参数1.8.查询轨迹类型: 在线订单工具接口名称:cargoTrackingService 1.8.1.请求参数1.8.2.返回参数1.9.申请拦截类型: 在线订单工具接口名称:cargoHoldService1.9.1.请求参数1.9.2.返回参数1.10.查询跟踪号类型: 在线订单工具接口名称:findTrackingNumberService 1.10.1.请求参数1.10.2.返回参数。

API接口文档(精简版)

API接口文档(精简版)

API接口文档(精简版)API接口文档(精简版)1. 简介该文档提供了有关API接口的详细信息,包括接口功能、请求参数、返回结果等内容。

开发人员可以通过此文档了解如何正确调用API接口,并获取所需的数据或实现特定功能。

2. 接口列表以下是可用的API接口列表:- 接口1:功能描述1接口1:功能描述1- 接口2:功能描述2接口2:功能描述2- 接口3:功能描述3接口3:功能描述33. 接口1该接口实现了功能描述1。

以下是该接口的详细信息。

3.1 请求URLGET /api/interface13.2 请求参数该接口不需要任何请求参数。

3.3 返回结果该接口返回以下结果。

{"result": "success","message": "接口调用成功","data": {"field1": "value1","field2": "value2"}}4. 接口2该接口实现了功能描述2。

以下是该接口的详细信息。

4.1 请求URLPOST /api/interface24.2 请求参数该接口需要以下请求参数。

4.3 返回结果该接口返回以下结果。

{"result": "success", "message": "接口调用成功", "data": {"field1": "value1","field2": "value2"}}5. 接口3该接口实现了功能描述3。

以下是该接口的详细信息。

5.1 请求URLPUT /api/interface3/{id}5.2 请求参数该接口需要以下请求参数。

API接口文档

API接口文档

tagParam[i] = t;}int i = PushManager.getInstance().setTag(context,tagParam, System.currentTimeMillis() +"");String text = "设置标签失败,未知异常";switch (i) {case PushConsts.SETTAG_SUCCESS:text = "设置标签成功";break;case PushConsts.SETTAG_ERROR_COUNT:text = "设置标签失败, tag数量量过⼤大, 最⼤大不不能超过200个"; break;case PushConsts.SETTAG_ERROR_FREQUENCY:text = "设置标签失败, 频率过快, 两次间隔应⼤大于1s";break;case PushConsts.SETTAG_ERROR_REPEAT:text = "设置标签失败, 标签重复";break;case PushConsts.SETTAG_ERROR_UNBIND:text = "设置标签失败, 服务未初始化成功";break;case PushConsts.SETTAG_ERROR_EXCEPTION:text = "设置标签失败, 未知异常";break;case PushConsts.SETTAG_ERROR_NULL:text = "设置标签失败, tag 为空";break;case PushConsts.SETTAG_NOTONLINE:text = "还未登陆成功";break;case PushConsts.SETTAG_IN_BLACKLIST:text = "该应⽤用已经在⿊黑名单中,请联系售后⽀支持!";break;case PushConsts.SETTAG_NUM_EXCEED:text = "已存 tag 超过限制";break;。

api接口文档模板

api接口文档模板

api接口文档模板一、概述API接口文档是软件开发过程中不可或缺的一部分,它扮演着向用户、开发者传达软件开发进度、设计思路和接口规范等信息的重要作用。

接口文档能够使得开发人员更快更准确地了解如何与软件程序进行交互,保证软件交互的可靠性和通用性,因此在软件开发过程中接口文档不可忽视。

二、文档要求1. 目的:该文档主旨在提供一套承载软件开发工程中的API接口标准和规范,方便开发工程师更快更准确地完成开发工作。

2. 适用人群:该文档适用于所有开发工程师,包括开发人员、测试人员、架构师等。

3. 范围:该文档涵盖了API接口的规范及其对应格式,包括接口URL,请求方式,请求参数,响应格式等。

三、API接口文档模板接口名称:xxxxxx接口地址:xxxxxx请求方式:xxxxxx接口描述:xxxxxx请求参数:参数名类型是否必须说明userId int 是用户ID userName string 是用户名userAge int 否用户年龄响应参数:参数名类型说明code int 返回状态码msg string 返回信息data array 返回数据数组返回示例:{"code": 200,"msg": "success","data": [{"userId": 1,"userName": "Tom", "userAge": 20},{"userId": 2,"userName": "Jerry", "userAge": 30}]}四、注意事项1. 接口名称应清晰、易懂;2. 接口地址需正确、完整;3. 请求方式必须准确,如GET、POST等;4. 请求参数需详细列出,包括参数名、类型、是否必须、说明等;5. 响应参数中code应准确反映请求状态,msg应准确反映请求信息,data为返回数据数组,需各参数对应说明;6. 返回示例需准确无误,并以易懂方式呈现。

api接口文档模板

api接口文档模板

api接口文档模板API接口文档模板。

一、接口概述。

API(Application Programming Interface)即应用程序接口,是软件系统中不同程序之间交换数据的约定。

API接口文档是对接口的详细说明,包括接口的功能、参数、返回结果等信息,供开发者使用和参考。

本文档旨在提供一个标准的API 接口文档模板,帮助开发者规范接口文档的编写。

二、接口信息。

1. 接口名称,。

2. 接口地址,。

3. 请求方法,。

4. 接口版本,。

5. 接口作者,。

6. 更新时间,。

三、接口功能。

(这部分需详细描述接口的功能和作用)。

四、请求参数。

1. 参数名称,。

参数类型,。

是否必填,。

2. 参数名称,。

参数类型,。

是否必填,。

参数说明,。

(依此类推,根据实际接口参数进行详细描述)。

五、返回结果。

1. 返回字段,。

字段类型,。

字段说明,。

2. 返回字段,。

字段类型,。

字段说明,。

(根据实际返回结果进行详细描述)。

六、错误码。

1. 错误码,。

错误信息,。

解决方案,。

2. 错误码,。

解决方案,。

(根据实际接口可能出现的错误码进行详细描述)。

七、示例。

请求示例:```。

{。

"参数1": "数值1",。

"参数2": "数值2"}。

```。

返回示例:```。

{。

"字段1": "数值1",。

"字段2": "数值2"}。

```。

八、接口权限。

(如果接口需要权限验证,需在此部分进行详细描述)。

九、其他注意事项。

(这部分可包括接口的调用频率限制、安全注意事项等)。

以上就是一个标准的API接口文档模板,希望开发者在编写接口文档时能够按照该模板进行规范化的操作,以便更好地进行接口的使用和维护。

同时,也希望在实际使用中能够不断完善和优化该模板,使其更符合实际需求。

api接口文档

api接口文档

API协议文档(v0.03)目录一、前言 (4)(一)适用范围 (4)(二)定义、专业术语及缩略语 (4)二、协议格式说明 (5)(一)事项申明 (5)(二)请求格式 (5)(三)输出格式及时间、数组的说明 (6)三、协议 (7)●公共接口 (7)1.版本检查 (7)2.设备注册 ................................................................................................................................. 错误!未定义书签。

●B端.......................................................................................................................................... 错误!未定义书签。

3.登录 ......................................................................................................................................... 错误!未定义书签。

4.获取未处理预约数 ................................................................................................................. 错误!未定义书签。

5.获取验证码 ............................................................................................................................. 错误!未定义书签。

API接口文档(简明版)

API接口文档(简明版)

API接口文档(简明版)概述本文档提供了对API接口的简明描述,旨在帮助开发人员理解和使用API接口。

API接口是用于不同应用程序之间进行通信和交互的一种方式。

基本信息- 接口名称:API接口- 版本号:1.0请求方法API接口支持以下请求方法:- GET:用于获取资源的信息- POST:用于创建资源- PUT:用于更新资源- DELETE:用于删除资源接口地址API接口的地址如下:接口参数API接口支持以下参数:- 参数1:用于...- 参数2:用于...返回结果API接口返回的结果采用JSON格式,示例如下:{"code": 200,"message": "请求成功","data": {"id": 1,"name": "John Doe",}}错误处理- 400:请求参数错误- 401:未授权访问- 404:资源不存在- 500:服务器内部错误示例代码以下是使用API接口的示例代码:import requestsresponse = requests.get(url)if response.status_code == 200:data = response.json()print(data)else:print("Error:", response.status_code)授权信息使用API接口需要进行身份验证。

请联系管理员获取授权信息,并在请求中包含相应的授权头信息。

其他注意事项- 请遵循相关的API使用规范和最佳实践,以实现良好的开发体验。

以上是API接口的简明文档,希望对开发人员有所帮助。

如有任何疑问,请联系技术支持团队。

西部数码API接口说明文档v2.0说明书

西部数码API接口说明文档v2.0说明书

西部数码A P I接口说明文档The documentation of WEST263 API(Application Programming Interface)版本号:v2.0作者: 西部数码发行日期:2015/1/25命令索引目录上传域名实名认证文件 (5)1.API接口地址 (7)2.参数说明 (7)2.1公共参数 (7)一、虚拟主机相关 (9)1.1开通正式/试用虚拟主机 (9)1.2修改FTP密码 (10)1.3主机续费 (10)1.4试用主机转正 (11)1.5主机升级 (11)1.6获取FTP密码 (12)1.7判断FTP是否使用 (13)1.8获取主机相关信息 (13)1.9虚拟主机绑定域名 (15)2.10删除绑定域名 (15)2.11虚拟主机流量充值 (16)2.22开通赠送MYSQL数据库 (16)二、域名相关接口 (17)2.1注册域名 (17)2.2修改域名密码 (20)2.3续费域名 (21)2.4开通URL转发 (21)2.5域名查询接口 (22)2.6添加域名解析记录 (22)2.7修改域名解析记录 (23)2.8删除域名解析记录 (24)2.9列举域名解析记录 (24)2.10提交域名转入 (25)2.11查询域名转入状态 (26)2.12修改域名DNS (27)2.13获取域名信息 (28)2.14上传域名实名认证文件 (29)2.15获取CN域名上传状态 (31)2.16获取域名资料上传状态 (32)三、数据库相关接口 (32)3.1开通赠送数据库 (32)3.2开通正式的数据库 (33)3.3修改数据库密码 (34)3.4续费数据库 (35)3.5试用转正 (35)四、邮局相关接口 (37)4.1开通收费/试用邮局 (37)4.2修改邮局密码 (37)4.3邮局续费 (38)五、其他功能 (39)5.1获取产品对应的机房列表 (39)5.2获取产品列表 (39)5.3获取FTP密码 (40)5.4获取邮局密码 (41)5.5获取数据库密码 (41)5.6获取可用金额 (42)5.7获取域名密码 (42)5.8升级企业邮局 (43)5.9升级数据库 (44)5.10申请发票 (44)5.11试用邮局转正 (45)5.12虚拟主机业务同步 (46)5.13域名业务同步 (48)5.14企业邮局业务同步 (49)5.15数据库业务同步 (50)5.16同步所有业务的密码 (51)5.17接口测试 (52)5.18获取成本价 (52)5.19获取虚拟主机产品的操作系统列表 (53)5.20获取业务到期时间 (54)5.21判断FTP是否存在 (54)5.22获取所有产品赠品信息 (55)5.23提交有问必答 (56)5.24获取有问必答内容 (57)5.25获取产品价格(域名,虚拟主机,邮局) (58)5.26获取VPS机房价格 (58)5.27获取VPS服务器机房参数 (59)5.28获取主站业务开通日志 (60)六、套餐云主机、VPS相关 (60)6.1云主机添加 (60)6.2主机续费 (63)6.3变更基本信息 (63)6.4主机升级 (64)七、其他函数 (66)7.1获取VPS或套餐云的机房信息 (66)7.2获取主机升级参数 (66)7.3查询虚拟主机购买的独立IP (68)八、弹性云主机 (70)8.1购买弹性云主机 (70)8.2弹性云主机升级 (72)8.3弹性云主机转正 (73)8.4云主机续费 (74)8.5变更云主机的附加信息(可选功能) (74)8.6弹性云主机重启、开机、关机 (75)8.7弹性云主机的状态变化 (76)8.8弹性云备份操作 (76)8.9弹性更换线路 (77)8.10获取白名单列表 (78)8.12删除白名单 (79)8.13重装系统 (79)8.14购买IP (80)8.15获取主机相关信息 (81)8.16添加工单 (82)8.17获取工单服务列表 (83)8.18获取有问必答回复 (84)8.19修改操作系统管理员密码 (84)8.20获取性能数据 (85)8.21修改独立控制面板密码 (86)版本变更说明修改日期版本号修改说明2008-1-1 1.3西部数码发布第一版api接口:/CustomerCenter/doc/west263-API.doc2013-7-26 2.02.0新版api接口发布,采用新的接口地址,格式跟老版本不兼容。

快递鸟接口技术文档说明书

快递鸟接口技术文档说明书

快递鸟接口(API)技术文档1前言 (5)2接口规范说明 (5)2.1接口规范及说明 (5)2.1.1报文及报文编码 (5)2.1.2接口数据包结构 (5)2.1.3JSON示例 (6)2.1.4系统级参数 (6)2.1.5流程示意图 (7)2.2签名说明 (7)2.2.1关于签名 (7)2.2.2(C#)DataSign签名加密代码 (9)3下单类接口 (10)3.1接入步骤 (10)3.2预约取件接口 (11)3.2.1功能说明 (11)3.2.2基本信息 (11)3.2.3接口规则 (12)3.2.4支持情况 (12)3.2.5应用级参数 (12)3.2.6返回参数 (17)3.3预约取件取消接口 (17)3.3.1功能说明 (17)3.3.2基本信息 (17)3.3.3接口规则 (18)3.3.4支持情况 (18)3.3.5应用场景 (18)3.3.6应用级参数 (18)3.3.7返回参数 (19)3.4电子面单接口 (19)3.4.1功能说明 (19)3.4.2基本信息 (19)3.4.3应用场景 (20)3.4.4接口规则 (20)3.4.6应用场景 (21)3.4.7应用级参数 (21)3.4.8返回参数 (30)3.5电子面单取消接口 (35)3.5.1功能说明 (35)3.5.2基本信息 (36)3.5.3接口规则 (36)3.5.4支持情况 (36)3.5.5应用级参数 (36)3.5.6返回参数 (37)3.6电子面单追加子单接口 (37)3.6.1功能说明 (37)3.6.2基本信息 (37)3.6.3应用级参数 (38)3.6.4返回参数 (38)3.7获取电子面单文件接口 (39)3.7.1功能说明 (39)3.7.2基本信息 (39)3.7.3应用级参数 (39)3.7.4返回参数 (40)4轨迹查询类接口 (42)4.1即时查询接口 (42)4.1.1功能说明 (42)4.1.2基本信息 (42)4.1.3接口规则 (42)4.1.4支持情况 (42)4.1.5应用场景 (42)4.1.6应用级参数 (42)4.1.7返回参数 (43)4.2物流跟踪 (45)4.2.1轨迹订阅接口 (45)4.3单号识别接口 (64)4.3.1功能说明 (64)4.3.2基本信息 (64)4.3.3接口规则 (64)4.3.4应用级参数 (64)4.3.5返回参数 (65)5增值类接口 (66)5.1在途监控-国内版 (66)5.1.1即时查询接口(增值版) (66)5.1.2物流跟踪接口(增值版) (72)5.2快递查询接口 (78)5.2.1功能说明 (78)5.2.2基本信息 (78)5.2.3接口规则 (78)5.2.4支持情况 (78)5.2.5应用场景 (78)5.2.6应用级参数 (78)5.2.7返回参数 (79)5.3在途监控-国际版 (84)5.3.1物流跟踪接口(国际版) (84)5.4物流查询地图接口 (86)5.4.1即时查询接口(地图版) (87)5.4.2物流跟踪接口(地图版) (95)5.5短信服务 (100)5.5.1短信模板接口 (101)5.5.2短信发送接口 (103)5.5.3短信黑名单接口 (105)5.6智能地址解析接口 (106)5.6.1功能说明 (106)5.6.2基本信息 (106)5.6.3应用级参数 (106)5.6.4返回参数 (107)6附录 (109)6.1对接相关资料 (109)6.2电子面单模板规格 (109)6.3返回编码列表 (116)7技术支持 (117)1前言快递鸟API旨在为电商、电商平台、物流工具、打单工具、仓储系统、移动APP等系统提供专业、稳定、优质的API接口服务,满足不同用户的物流管理需求。

  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

接口:
接口泛指实体把自己提供给外界的一种抽象化物,用以由内部操作分离出外部沟通方法,使其能被内部修改而不影响外界其他实体与其交互的方式。

在计算机中,接口是计算机系统中两个独立的部件进行信息交换的共享边界。

这种交换可以发生在计算机软、硬件,外部设备或进行操作的人之间,也可以是它们的结合。

API:
API是一些预先定义的函数,或指软件系统不同组成部分衔接的约定。

用来提供应用程序与开发人员基于某软件或硬件得以访问的一组例程,而又无需访问源码,或理解内部工作机制的细节。

简介:
操作系统是用户与计算机硬件系统之间的接口,用户通过操作系统的帮助,可以快速、有效和安全、可靠地操纵计算机系统中的各类资源,以处理自己的程序。

为使用户能方便地使用操作系统,OS 又向用户提供了如下两类接口:
用户接口:操作系统专门为用户提供了“用户与操作系统的接口” ,通常称为用户接口。

该接口支持用户与OS 之间进行交互,即由用户向OS 请求提供特定的服务,而系统则把服务的结果返回给用户。

程序接口:操作系统向编程人员提供了“程序与操作系统的接口” ,简称程序接口,又称应用程序接口API。

该接口是为程序员
在编程时使用的,系统和应用程序通过这个接口,可在执行中访问系统中的资源和取得OS 的服务,它也是程序能取得操作系统服务的唯一途径。

大多数操作系统的程序接口是由一组系统调用(system call)组成,每一个系统调用都是一个能完成特定功能的子程序。

应用程序接口又称为应用编程接口,是一组定义、程序及协议的集合,通过API接口实现计算机软件之间的相互通信。

API 的一个主要功能是提供通用功能集。

API同时也是一种中间件,为各种不同平台提供数据共享。

程序设计的实践中,编程接口的设计首先要使软件系统的职责得到合理划分。

良好的接口设计可以降低系统各部分的相互依赖,提高组成单元的内聚性,降低组成单元间的耦合程度,从而提高系统的可维护性和可扩展性。

相关文档
最新文档