API文档目录

图片访问方式说明


智能应用服务内的很多API,都会返回抓拍数据的图片URL地址,该地址为图片实际存储的存储服务器地址。平台会有多个存储服务器地址。
1:当调用者和存储服务器在同一网段:则可直接通过API返回的图片URL进行获取,如下图所示:

2:当调用者和平台不在同一网段时(如:平台在网段1,调用者在网段2),一般会通过映射的方式,把平台的IP映射出去,使得调用者能顺利访问到平台发布的API。但是存储服务器的IP一般不会做映射,这就导致了调用方在网段2无法直接向存储服务器访问图片。

由于平台无法判断调用者得图片URL后,会在哪个网段去使用该图片。此时,需要调用者对获得的URL字符串做额处理,重新封装成通过平台IP访问的图片URL,通过平台的代理,可以使得调用者在网段2能得到图片数据。如下图:

重新组装图片URL的规则为:
组装后的URL= “https://” +平台IP+”:” +平台PORT+” /ngx/proxy?i=”+ Base64(原始图片URL) 。其中平台IP和PORT即为智能应用平台的IP和PORT,Base64()为对字符串进行Base64编码的函数。

以实际数据举例:
平台映射到网段2的IP:ip
平台PORT:port
图片原始URL:http://ip:port/pic?id=adfagafaldjfadfjaf
图片原始ULR通过Base64编码后得到字符串:aHR0cDovLzEwLjMzLjQyLjE2MTo2MTIwL3BpYz9pZD1hZGZhZ2FmYWxkamZhZGZqYWY=

组装后,可在网段2访问的图片URL: https://ip:port/ngx/proxy?i=aHR0cDovLzEwLjMzLjQyLjE2MTo2MTIwL3BpYz9pZD1hZGZhZ2FmYWxkamZhZGZqYWY=

注:
1:主流编程语言(JAVA、C++、PHP、C#等),都有现成的工具类,支持对字符串进行Base64编码,请使用者自行寻找。
2:可通过网站http://tool.oschina.net/encrypt?type=3 测试字符串的Base64编解码效果。