AcroSuite

ToolSet for Cloud Service

日本語 中文 English

AcroSuiteは、RestGateのAPI群から抜粋した個別の利用ツール集であり、現在はジオメトリ判別、隣接ポイント抽出、クラスター生成、IPによる地区特定、暗号化・復号化・電子署名、メール配信、ワンタイム又は複数回認証、OpenID Connect連携認証、サードパーティーAPIの呼び出し、WebSocketリアル通信などの機能が含まれています。

ジオメトリ

Name	Type	URL	JsonParam	QueryParam
02301002	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/geometry/ispoint	{ "geom": "POINT(139.769054 35.680877)" }
	座標（経度・緯度）の値の正確性をチェックします。

02301003	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)" }
	LineStringの座標(経緯度)セット(WKT形式)を引き渡し、OGC標準を参照して構文をチェックします。交差がある場合はFALSEが返されます。

02301004	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))" }
	Polygonの座標(経緯度)セット(WKT形式)を引数に渡し、OGC標準に基づいて構文をチェックします。もし交差や反時計回りの内部頂点や時計回りの外部頂点が存在する場合、FALSEが返されます。

02301005	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	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	get	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/iploc		apiCode=&apiHeader=&accountId=&apiKey=&ip=&lon=&lat=
	IPアドレスの所在地区を取得します。ipパラメータを省略すると、クライアントPCのPublicIPアドレスが使用されます。

暗号化/復号化

Name	Type	URL	JsonParam	QueryParam
02301008	get	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/cipher/rsakey
	RSA暗号の公開鍵と秘密鍵を生成します。

02301009	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/cipher/signature	{ "publicKey": "H4sIAAAAAA...AA", "privateKey": "H4sIAAAAA...A==", "signName": "User2002_1" }
	RSA Keyを使って電子署名を生成し、事前にRSA Keyを用意する必要があります。

02301010	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" }
	RSA暗号化によって電子署名を検証します。

02301011	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	get	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/mail/isvalidaddress		emails=
	メールアドレスの構文とドメインを検証し、最大で20個のアドレスを扱うことができます。

02301013	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" } }
	このAPIは、コンテンツの種類を指定してメール送信を行うためのものです。電子署名も可能です。スパムメールを防ぐため、fromAddressの構文とドメインを検証します。userSignatureは省略可能です。送信者認証(fromAddress)のため、送信用のメールアドレス又はドメインを送ってください。送信ドメインの場合は、こちらからDNSの設定情報を返送し、それに従って、ドメインDNSに設定いただく必要があります。 -toAddress、ccAddress、bccAddressのトータル件数上限は20件です。 -subjectとmailbodyのトータルサイズ上限は20MBです。

認証

Name	Type	URL	JsonParam	QueryParam
02301014	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を発行し、アクセス回数や有効期間を設定し、メール通知も可能です。ワンタイム認証または複数回認証の場面で利用されます。このAPIを呼び出す際には、アクセス検証により有効性を確認します。

02301015	post	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/issue/auth	{ "accessKey": "ABCDEFGHJ", "password": "********" }
	発行したAccessKeyとPassword、アクセス回数や有効期間によって、ワンタイム認証または複数回認証のアクセスの有効性を検証します。

02301016	get	https://www.restgate.net:8443/AcroSuite/v0_1/CstService/tools/oauth/oidclist		oAuthCode=&redirectHost=&redirectPort=
	サードパーティプロバイダー（Google/LINE/Yahoo! JAPAN/Azure）から、OAuth OpenID Connect（OIDC）の認証情報を取得します。このAPIを呼び出すと、OIDC一覧（oAuthCodeなしの場合）または認証情報（oAuthCodeありの場合）が返されます。 OIDC一覧が返された場合は、続けてOAuthURLを選択して呼び出すことで、該当する認証情報を取得できます。

APIプロキシ

Name	Type	URL	JsonParam	QueryParam
	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": "" } ] } ] }	getHtmlValue=false
	JSON形式のCookie/Header/Path/Objectパラメータを、サードパーティーのエンドポイント（URI）に渡し、JSON/XML/HTMLなどの形式の戻り値を取得します。 - methodType: GET/POST/PUT/DELETE - dataType: JSON/XML/FORM - responseType: JSON/XML/HTML ※getHtmlValue=true: 戻り値がhtmlの場合、title/keywords/description/links/images/bodyの値を取り出してjson形式に変換します。

	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 } ] } ] }	getHtmlValue=false
	JSON形式のCookie/Header/Path/Objectパラメータを、OpenAIのエンドポイント（URI）に渡し、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

Webメッセンジャー

Name	Type	URL	JsonParam	QueryParam
02301018	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

	このWebメッセンジャーは、groupname/usernameを自由に定義して、地理情報座標、テキスト、およびバイナリファイルのリアルタイム送受信をサポートしています。テキストの送受信形式はjsonであり、正式運用では認証・認可をサポートし、cmdは管理者用コマンドを指します。 ※上限設定：グループ数20、グループ内のユーザー数100、テキストサイズ20KB、バイナリサイズ2MB ※json定義：from送信者、to受信者、group所属グループ、x経度、y緯度、z高さ、xyAccuracy経緯度誤差、zAccuracy高さ誤差、heading方位角、speed速度 ※送受信内容は、API側に一切保存されません。詳細についてはオンラインヘルプをご覧ください。また、ご利用するブラウザはWebSocketに対応している必要があります。