openapi: '3.0.2' info: title: Service Gateway API description: "ServiceGateway 主要功能在於調度一個 Service Area 內實際提供服務的主機,以企業雲環境而言,單一企業所使用的 OmniStor 通常僅代表一個 Area。

ServiceGateway 中用來授權驗證使用者的API是 /member/acquiretoken/,該 API 會回傳 Token、InfoRelay 以及 WebRelay 的位址給客戶端。接著,客戶端便可以帶著 ServiceGateway 所核發的 Token 自由使用 InfoRelay 和 WebRelay 提供的 API 開發 OmniStor 的相關服務。" version: '0.9' servers: - url: https://sgd01.asuswebstorage.com paths: /member/acquiretoken/: post: summary: Acquire token - 於驗證使用者帳號密碼身份之後,核發 Token 以及對應的服務位置。 tags: - Authentications parameters: - in: header name: Cookie schema: type: string required: true description: 提供 SID 與客戶端相關訊息 example: sid=19760929;c=0;v=1.0;EEE_MANU=MacOS;EEE_PROD=POSTMAN;OS_VER=11.2.3; - in: header name: Authorization schema: type: string required: true description: 以 Program Key 所產生的 Authorization String example: signature_method="HMAC-SHA1",timestamp="1560761805238799",nonce="SavcrfLkKJKrzEcklIfx",signature="DXKDqne5TKrcAzeh%2F6UXdn9yHrg%3D" requestBody: description: 取得用戶所在區域的 Service Gateway 網址 content: application/xml: schema: $ref: '#/components/schemas/aaa' responses: 200: description: OK content: application/xml: schema: xml: name: aaa type: object properties: status: type: integer servicegateway: type: string accountmodel: type: string accountsyncstate: type: string liveupdateuri: type: string time: type: integer examples: Success: value: status: 0 servicegateway: sgd01.asuswebstorage.com accountmodel: ASUS_SYNCABLE accountsyncstate: 1 liveupdateuri: http://dl.asuswebstorage.com/asuswebstorage/client_update/updater/AsusWSUpdater.exe time: 1617250064991 "Authentication Fail": value: status: 2 time: 1617250064992 "General Error": value: status: 999 time: 1617250064993 components: schemas: aaa: type: object properties: userid: type: string description: 用戶帳號 symmetrypwd: type: string description: 將密碼以 Triple-DES 處理過後之字串 time: default: -1 type: integer