AcroSuite

ToolSet for Cloud Service

日本語 中文 English

AcroSuiteは、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)" }
	LineStringの座標(経緯度)セット(WKT形式)を引き渡し、OGC標準を参照して構文をチェックします。交差がある場合は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))" }
	Polygonの座標(経緯度)セット(WKT形式)を引数に渡し、OGC標準に基づいて構文をチェックします。もし交差や反時計回りの内部頂点や時計回りの外部頂点が存在する場合、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パラメータを省略すると、クライアントPCのPublicIPアドレスが使用されます。

暗号化/復号化

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 Keyを使って電子署名を生成し、事前にRSA Keyを用意する必要があります。

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

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" } }
	このAPIは、コンテンツの種類を指定してメール送信を行うためのものです。電子署名も可能です。スパムメールを防ぐため、fromAddressの構文とドメインを検証します。userSignatureは省略可能です。送信者認証(fromAddress)のため、送信用のメールアドレス又はドメインを送ってください。送信ドメインの場合は、こちらからDNSの設定情報を返送し、それに従って、ドメインDNSに設定いただく必要があります。 -toAddress、ccAddress、bccAddressのトータル件数上限は20件です。 -subjectと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を発行し、アクセス回数や有効期間を設定し、メール通知も可能です。ワンタイム認証または複数回認証の場面で利用されます。このAPIを呼び出す際には、アクセス検証により有効性を確認します。

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/Yahoo! JAPAN/Azure）から、OAuth OpenID Connect（OIDC）の認証情報を取得します。このAPIを呼び出すと、OIDC一覧（oAuthCodeなしの場合）または認証情報（oAuthCodeありの場合）が返されます。 OIDC一覧が返された場合は、続けてOAuthURLを選択して呼び出すことで、該当する認証情報を取得できます。

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

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	ocrLangjpn 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ファイルのみ有効 pageNo: pdf->画像に変換したページ番号、pdfMode=2有効、１API呼び出しで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

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