AcroSuite

ToolSet for Cloud Service

中文 日本語 English

AcroSuite作为单独利用的API工具集，是从RestGate各个API群里拔萃出来的，现在包括地理数据判别、抽取邻接点、生成点簇、IP地区定位、加解密和数字签名、发送邮件、一次性或多次认证访问、OpenID Connect关联认证、第三方API代理调用、WebSocket实时通信、文件OCR等功能。
**点击按钮下面的链接，可以打开相应I/F帮助页面(html)和OpenAPI规范(json/yaml)。

地理信息

Name	Type	URL	JsonParam	QueryParam
02301002 json yaml	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/geometry/ispoint	{ "geom": "POINT(139.769054 35.680877)" }
	检查经纬度坐标值的有效性。

02301003 json yaml	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/geometry/isline	{ "geom":"LINESTRING(139.632447 35.633454,139.630939 35.714560,139.712362 35.768352,139.798481 35.725624)" }
	按照OGC标准检查LineString的经纬度坐标集(WKT形式)。若有交叉，返回FALSE。

02301004 json yaml	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/geometry/ispolygon	{ "geom": "POLYGON((139.421134 35.904979,140.238484 35.767676,140.156450 35.441841,139.433170 35.392131,139.421134 35.904979))" }
	按照OGC标准检查Polygon经纬度坐标集(WKT形式)。若有交叉、内环逆时针、外环顺时针则返回FALSE。

02301005 json yaml	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/geometry/neighbors	{ "type": "MultiPoint", "coordinates": [ [139.421134, 35.904979],[140.238484, 35.767676],[140.156450, 35.441841],[139.433170, 35.392131],[138.421134, 36.904979] ] }	maxCount=&maxDistance=&withDistance=&withDirection=
	赋予一组点坐标集(经纬度)、以第一个点为中心获取指定距离范围以内的邻接点。返回点序号、坐标(经纬度)、距离和方向角。赋予点数量上限：1000

02301006 json yaml	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/geometry/clusters	{ "type": "MultiPoint", "coordinates": [ [139.421134, 35.904979],[140.238484, 35.767676],[140.156450, 35.441841],[139.433170, 35.392131],[138.421134, 36.904979] ] }	maxDistance=&withCoordinates=
	赋予一组点坐标集(经纬度)、生成指定距离范围的点簇。返回序号、中心坐标(经纬度)、簇内点坐标集(经纬度)。赋予点数量上限：1000

02301007 json yaml	get	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/iploc		apiCode=&apiHeader=&accountId=&apiKey=&ip=&lon=&lat=
	根据IP地址获取所在地区。若省略ip参数，以客户端公共IP来检索

加解密

Name	Type	URL	JsonParam	QueryParam
02301008 json yaml	get	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/cipher/rsakey
	生成RSA加解密的公钥和密钥。

02301009 json yaml	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/cipher/signature	{ "publicKey": "H4sIAAAAAA...AA", "privateKey": "H4sIAAAAA...A==", "signName": "User2002_1" }
	根据RSA公钥和密钥生成电子签名。

02301010 json yaml	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/cipher/isvalidsignature	{ "publicKey": "H4sIAAAA...AA", "signature": "H4sIAA...AA==", "signDT": "2020-04-27 17:12:31.519", "signHash": "lmTcHazlUGh7IY8qS5J1VQ", "signName": "User2002_1" }
	验证电子签名。

02301011 json yaml	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/cipher/message	{ "cipherKey": "H4sIAAAA...AA==", "keyType": 1, "message": "123456" }	cipherType=
	利用RSA公钥和密钥进行信息加解密处理。

电子邮件

Name	Type	URL	JsonParam	QueryParam
02301012 json yaml	get	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/mail/isvalidaddress		emails=
	检查邮件地址语法和域的有效性，可以检查多个地址，20个为止。

02301013 json yaml	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/mail	{ "mailSubject": "勤怠通知", "mailBody": "ただいま、出社しております。", "contentType": "text/plain;charset=UTF-8", "toAddress": "******@hotmail.co.jp", "ccAddress": "", "bccAddress": "", "fromAddress": "******@outlook.com", "asynFlag": false, "userSignature": { "publicKey": "H4sIAAA...AA", "signature": "H4sIAAA...AA", "signDT": "2020-04-27 17:12:31.519", "signHash": "lmTcHazlUGh7IY8qS5J1VQ", "signName": "User2002_1" } }
	指定Contents种别发送邮件，可以带电子签名。为了防止spam邮件，检查fromAddress语法和域的有效性。userSignature可以省略。为了验证发件人（fromAddress），请告知我们您的发送电子邮件地址或域名。如果选择发送域，我们将向您返回 DNS 配置信息，您需要相应地配置您的域 DNS。 -toAddress, ccAddress and bccAddress总件数上限: 20 -subject and mailbody的合计大小上限: 20MB

认证

Name	Type	URL	JsonParam	QueryParam
02301014 json yaml	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/issue/access	{ "accessKey": "ABCDEFGHJ", "startDT": null, "endDT": null, "useLimit": 0, "passLength": 16, "emailObj": { "mailSubject": "PasswordNotice", "mailBody": null, "contentType": "text/plain;charset=UTF-8", "toAddress": "******@outlook.com", "ccAddress": "", "bccAddress": "", "fromAddress": "******@outlook.com", "asynFlag": false, "userSignature": { "publicKey": "H4sIAAA...AA", "signature": "H4sIAAA...AA", "signDT": "2020-04-27 17:12:31.519", "signHash": "lmTcHazlUGh7IY8qS5J1VQ", "signName": "User2002_1" } } }
	发行一次性或多次性AccessKey和Password，设定访问次数和有效期间，可以发邮件通知。

02301015 json yaml	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/issue/auth	{ "accessKey": "ABCDEFGHJ", "password": "********" }
	根据发行的AccessKey和Password、访问次数及有效期间，验证一次性或多次性访问的有效性。

02301016 json yaml	get	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/oauth/oidclist		oAuthCode=&redirectHost=&redirectPort=
	从第三方运营商(Google/LINE/YahooJP/Azure)获取からOAuth OpenID Connect(OIDC)的认证信息。调用这个API后，若不带oAuthCode参数返回OIDC一览，若带oAuthCode则登录返回OpenID Connect(OIDC)的认证信息。返回OIDC一览时，可以选择有关运营商，经过登录获取有关的认证信息。

API代理访问

Name	Type	URL	JsonParam	QueryParam
02006006 json yaml	post	https://www.restgate.net:8443/AirMeasurer/v0_7/CstService/exchanger/endpoints/gear	{ "endpointUri": "https://www.sample.com", "endpointName": "testEP1", "methodType": "get", "dataType": "json", "responseType": "json", "cookies": [ { "cookieName": "testCookie", "cookieType": "String", "cookieConfig": null, "value": "" } ], "headers": [ { "headerName": "testHeader", "headerType": "String", "value": "" } ], "paths": [ { "pathName": "testPath", "pathType": "Number", "value": "" } ], "queries": [ { "queryName": "testQuery", "queryType": "Number", "value": "" } ], "objects": [ { "objectName": "testObject", "objectType": "json", "objectItems": [ { "itemName": "testItem", "itemType": "String", "value": "" } ] } ] }	retStyle=0
	向第三方的Endpoint(URI)以JSON格式传递Cookie/Header/Path/Object参数(可选)，返回JSON/XML/HTML/Markdown等格式的数据。 - methodType: GET/POST/PUT/DELETE - dataType: JSON/XML/FORM - responseType: JSON/XML/HTML * retStyle: 指定返回形式(=0: html; =1: json; =2: markdown)。

02006006 json yaml	post	https://www.restgate.net:8443/AirMeasurer/v0_7/CstService/exchanger/endpoints/gear	{ "endpointUri": "https://api.openai.com/v1/chat/completions", "endpointName": "testEP1", "methodType": "post", "dataType": "json", "responseType": "json", "headers": [ { "headerName": "Authorization", "headerType": "String", "value": "Bearer sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } ], "objects": [ { "objectName": "testObject", "objectType": "json", "objectItems": [ { "itemName": "model", "itemType": "String", "value": "gpt-3.5-turbo" }, { "itemName": "messages", "itemType": "Object", "value": "[{\"role\": \"user\", \"content\": \"Can you tell me whether People will be replaced by AI or not?\"}]" }, { "itemName": "temperature", "itemType": "Number", "value": 0.7 } ] } ] }
	向OpenAI的Endpoint(URI)以JSON格式传递Cookie/Header/Path/Object参数(可选)，返回JSON等格式的数据。 - methodType: GET/POST/PUT/DELETE - dataType: JSON - responseType: JSON endpointUri, Authorization, Model, messages, temperature and other parameters are required. API reference https://platform.openai.com/docs/api-reference

02006007 json yaml	post	https://www.restgate.net:8443/AirMeasurer/v0_7/CstService/exchanger/endpoints/crawler	{ "endpointUri": "https://www.sample.com" }	retStyle=0
	* retStyle: 指定返回形式(=0: html; =1: json; =2: markdown)。

文件工具

Name	Type	URL	FormParam	QueryParam
02301003 json yaml	post	https://www.restgate.net:8443/DocOrganizer/v0_1/CstService/tools/fileocr	ocrLangchi_sim ocrMode3 ocrData2 pdfMode0 pageNo1 noSpacetrue
	ocrLang: OCR对应语言 eng,jpn,jpn_vert,chi_sim,chi_sim_vert,chi_tra,chi_tra_vert ocrMode: 0=OEM_TESSERACT_ONLY,1=OEM_LSTM_ONLY,2=OEM_TESSERACT_LSTM_COMBINED,3=OEM_DEFAULT ocrData: 0=normal,1=best,2=fast best/fast 仅在ocrMode=1/3lstm模式下有效 pdfMode: 0=仅抽取文字,1=仅抽取图像, 2=pdf转换为图像再OCR处理仅针对pdf文件,1-2模式下速度较慢 pageNo: pdf转换为图像的页面号码,仅在pdfMode=2有效,每次调用仅处理1页 noSpace: true=从处理结果里删除空格图像文件格式: JPG/JPEG/PNG/TIFF/BMP/PNM/GIF/WEBP/JP2/PDF, 上传文件大小上限1MB。 *OCR处理结束以后，删除上传文件，不做保存。

02301004 json yaml	post	https://www.restgate.net:8443/DocOrganizer/v0_1/CstService/tools/pdf/text
	文件格式: PDF, 上传文件大小上限1MB。 *处理结束以后，返回文本文件，删除上传文件，不做保存。

02301005 json yaml	post	https://www.restgate.net:8443/DocOrganizer/v0_1/CstService/tools/pdf/table		pages=1,2&units=300&left=1.2&top=3.5&width=200&height=45&rotation=&separator=09
	pages: 处理页号字符串 units: 处理分辨率, 单位: 像素 left: 左边距, 单位: 毫米 top: 头边距, 单位: 毫米 width: 宽度, 单位: 毫米 height: 高度, 单位: 毫米 rotation: 旋转角度, 0,90,180,270度 separator: 间隔符, 16进制ASCII码文件格式: PDF, 上传文件大小上限1MB。 *处理结束以后，返回文本文件，删除上传文件，不做保存。

02301006 json yaml	post	https://www.restgate.net:8443/DocOrganizer/v0_1/CstService/tools/pdf/image
	文件格式: PDF, 上传文件大小上限1MB。 *处理结束以后，返回zip文件，删除上传文件，不做保存。

02301007 json yaml	post	https://www.restgate.net:8443/DocOrganizer/v0_1/CstService/tools/pdf/2image		pages=1,2
	文件格式: PDF, 上传文件大小上限1MB。 *处理结束以后，返回zip文件，删除上传文件，不做保存。

Web实时通信

Name	Type	URL	JsonParam	QueryParam
02301018 json yaml	WebSocket	wss://www.restgate.net:8443/AcroSuite/CstMessenger/{groupname}/{username}		cmd=&group=&user=
			{ "x": 0, "y": 0, "z": 0, "to": "user222", "content": "Hello world!" }
			Select file

	自由定义groupname/username，支持发送地理坐标、文本和二进制文件的收发信实时通信。文本信息的收发信格式是json，正式使用对应认证认可，cmd为管理者用命令。 * 上限设定：group数20, group内user数100, 文本大小20KB, 二进制文件大小2MB * json定义：from发信者, to收信者, group所属群, x经度, y纬度, z高度, xyAccuracy经纬度误差, zAccuracy高度误差, heading方向角, speed速度 * API端不保存收发信内容。详细请参照在线帮助。另外所用浏览器需要支持WebSocket。