情報note |
---|
現在の最新は、2.0.4 追加更新中になります。 |
Swagger open api macro |
---|
swagger: "2.0" info: description: "WhatYaAPI'sの仕様に基づき、RestAPIのリクエストに対するレスポンスのExampleWhatYaAPIのメッセージリクエストに対するメッセージレスポンスのサンプル\n ※APIのみを利用してV2機能(オペレーターと接続・会話)を利用する場合、別サーバーを必要とします。\n この場合、通常の通信方式(Websocket)とは異なり、Webfookを利用した連携接続となります。\n 別途ご相談ください。" version: "12.10.20" title: "KeelWhatYa responsesresponse examples" termsOfService#termsOfService: "http://swagger.io/terms/" contact: email: "info@solairo.co.jp" license: name: "SOLAIRO,Inc." url: "http://www.solairo.co.jp" host#host: "[client]-[appli].bwing[server-no].app" basePath#basePath: "/whatya/[client code]" schemes: - "https" paths: /post/message, /get/messages (text type): post: tags: - "Text Normaltext" summary: "※POST, GET same response content." description: "※POST, GET same response content." externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "Text NormalTextのみの応答メッセージ" schema: $ref: "#/definitions/TextNormalText" /get/messages (text type): get: tags: - "Text Normaltext" summary: "※POST, GET same response content." description: "※POST, GET same response content." externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "Text NormalTextのみの応答メッセージ" schema: $ref: "#/definitions/TextNormalText" /post/message, /get/messages (link type): post: tags: - "Link" summary: "※POST, GET same response content." description: "" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Link" /get/messages (link type): get: tags: - "Link" summary: "※POST, GET same response content." description: "" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Link" /post/message, /get/messages (Tel type): post: tags: - "Tel" summary: "※POST, GET same response content." description: "" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Tel" /get/messages (Tel type): get: tags: - "Tel" summary: "※POST, GET same response content." description: "" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Tel" /post/message, /get/messages (Mail type): post: tags: - "Mail" summary: "※POST, GET same response content." description: "" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Mail" /get/messages (Mail type): get: tags: - "Mail" summary: "※POST, GET same response content." description: "" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Mail" /post/message, /get/messages (Image (Image type): post: tags: - "Image" summary: "※POST, GET same response content." description: "" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Image" /get/messages (Image type): get: tags: - "Image" summary: "※POST, GET same response content." description: "" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Image" /post/message, /get/messages (Item Image Sliders type): post: tags: - "Sliders" summary: "※POST, GET same response content." description: "keyが文字、valueが画像の組み合わせのスライダー" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/ItemImageSlider" /get:/messages (Item Image Sliders type): get: tags: - "Sliders" summary: "※POST, GET same response content." description: "keyが文字、valueが画像の組み合わせのスライダー" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/ItemImageSlider" /post/message, /get/messages (Chips type): post: tags: - "Chips" summary: "※POST, GET same response content." description: "key, value ともに文字のみのチップ" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/StringStringChip" /get/messages (Chips type): get: tags: - "Chips" summary: "※POST, GET same response content." description: "key, value ともに文字のみのチップ" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/StringStringChip" /post/message, /get/messages (Lists type): post: tags: - "Lists" summary: "※POST, GET same response content." description: "リスト形式で表示" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Lists" get/get/messages (Lists type): get: tags: - "Lists" summary: "※POST, GET same response content." description: "" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Lists" /post/message (Dialog): post: tags: - "Dialog" summary: "" description: "ダイアログとその内容※【仕様調整中】ダイアログとその内容" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Dialog" /post/message, /get/messages (Cards type): post: tags: - "Cards" summary: "※POST, GET same response content." description: "画像の下に説明文を添えるCard型のメッセージタイプ" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Cards" /get/messages (Cards type): get: tags: - "Cards" summary: "※POST, GET same response content." description: "" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Cards" /post/message, /get/messages (Takeover2Op): post: tags: - "Takeover2Op" summary: "【別途サーバー準備必要】オペレータ引き継ぎ" description: "オペレータに引き継ぐためのメッセージタイプ。\nオペレータに引き継ぐためのメッセージタイプ。\ncontent.message は null または 空文字列でもよい。その場合はメッセージ無しでオペレータに引き継ぐ。" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Takeover2Op" /post/message (Newest): post: tags: - "Newest" summary: "最新情報掲載" description: "Newest(最新情報)が更新されたことをお知らせするSnackBarを表示する際に使用する。" externalDocs: description: "Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/136019997137003029/APIWhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Newest" definitions: TextNormal /post/message (Youtube type): examplepost: typetags: "text" - content:"Youtube" messages summary: "Hello!! This is Bot answer※POST, GET same response content." Link: example: typedescription: "markdownYoutube動画ストリーミングのメッセージタイプ" contentexternalDocs: messages description: "リンクは[こちら](http://www.solairo.co.jp/)" Tel: example:Parameters : See WhatYa's API" typeurl: "telephonehttps://solairo.atlassian.net/wiki/spaces/WHAT1/pages/137003029/WhatYa+APIs" contentresponses: messages200: : "サポートセンターへの電話はこちら" valuedescription: "0120-116-116" Mail: example: schema: type: "mail" content $ref: "#/definitions/Youtube" /get/messages (Youtube type): messages : "サポートセンターへのメールはこちら" value: "support@solairo.co.jp" get: Image: exampletags: type:- "imageYoutube" contentsummary: "※POST, GET same response content." messages description: "Hello!! This is Bot answer." Youtube動画ストリーミングのメッセージタイプ" externalDocs: img_url description: "https:Parameters : See WhatYa's API" url: "https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/137003029/WhatYa+APIs" responses: 200: description: "" schema: $ref: "#/definitions/Youtube" definitions: Text: example: type: "text" content: messages : "Hello!! This is Bot answer." Link: example: type: "markdown" content: messages : "リンクは[こちら](http://www.solairo.co.jp/)" Tel: example: type: "telephone" content: messages : "サポートセンターへの電話はこちら" value: "0120-116-116" Mail: example: type: "mail" content: messages : "サポートセンターへのメールはこちら" value: "support@solairo.co.jp" Image: example: type: "image" content: messages : "Hello!! This is Bot answer." img_url : "https://bucket.com/item/2.png" alt : "not image" ItemImageSlider: example: type: "item_image_slider222" content: messages : "Please choice!" sliders: - img_url : "https://bucket.com/item/1.png" item_name : "item 1 xxxx" item_value : "item1" price : "¥10000" size : "S" stock : 1 - img_url : "https://bucket.com/item/item/2.png2.png" item_name : "item 2 xxxx" item_value : "item2" price : "¥20000" size : "M" alt stock : "not2 image" ItemImageSliderStringStringChip: example: type: "itemstring_imagestring_slider222chip" content: messages : "Please choice!choose one." sliderschips: - img_url : "https://bucket.com/item/1.png" item_name : "item 1 xxxxYes" item_value : "item1Yes" price - item_name: "¥10000No" size item_value: "SNo" stock Lists: 1 example: - img_url type: "https://bucket.com/item/2.png"list" content: item_name message: "itemPlease 2choose xxxxsomething." lists: - item_value name: "item2Yes" price item_value: "¥20000Yes" size - item_name: "MNo" stock item_value: 2"No" StringStringChipDialog: example: type: "string_string_chipdialog" content: messagesmessage: "Please choose oneseason." chips: - item_namechip_accept: "Yesshow dialog" itemchip_valuedeny: "Yesdeny" - itemdialog_nameitems: "No" - item_valuetype: "No" Lists:select" example: typelabel: "list"your favorite season" content: messagekey: "Pleasekey1" choose something." listsdialog_values: - item_name: "Yes春" item_value: "YesSpring" - item_name: "No夏" item_value: "NoSummer" Dialog: example: type- item_name: "dialog秋" content: message: "Please choose season." chipitem_acceptvalue: "show dialog"Autumn" - chipitem_denyname: "deny冬" dialogitem_itemsvalue: "Winter" - type: "select" label: "your favorite seasoncolor" key: "key1key2" dialog_values: - item_name: "春赤" item_value: "SpringRed" - item_name: "夏青" item_value: "SummerBlue" - item_name: "秋黄" item_value: "AutumnYellow" - item_name: "冬緑" item_value: "WinterGreen" - type: "please next 2..."DatePicker" - typelabel: "pelase next 3 "...." Cards: example: type: "image_card" content: messages : "今日のメニュー" image: "http://www.image.com/new/content/1" text: "メニュー内容" link: label: "詳細はこちら" url: "https://www...." Takeover2Op: example: type: "takeover_to_op" content: messages : "オペレータに引き継ぎます。" Newest: example: type: "normal" update_at: 1574246097042 content: messages : "最新情報だよ" value: "LINKAGE-Newest" Youtube: example: type: "youtube" content: messages : "This is the best movie." videoId: "L7lc1UVf-VE" autoplay: "true" externalDocs: description: "Find out more about Swagger" url: "http://swagger.io" |
...