如何与他人共享“`AsyncAPI`”文档？

Question

有没有办法与其他人共享AsyncAPI文档？我使用AsyncAPI工作室编写API文档。但我在AsyncAPI工作室找不到股票期权。在AsyncAPI Studio/其他AsyncAPI编辑器中是否有一种方法可以用来与其他人共享我们的AsyncAPI文档？

在SwaggerHub中，我们可以与其他人共享rest文档，这些文档是使用OpenAPI规范编写的。

Answer 1

是的，你有这个可能性，但有限的。Studio不会将您的规范保存在云中(没有服务器)，但是如果您的规范是通过http在某个地方共享的，那么您可以使用url参数和readOnly参数-后者决定工作室是否应该使用编辑器来呈现规范。

也可以使用base64参数，但由于链接长度有限，只能用于较小的规范。

示例：

• 使用url参数：https://studio.asyncapi.com/?url=https://raw.githubusercontent.com/asyncapi/spec/master/examples/gitter-streaming.yml&readOnly
• 使用base64参数：https://studio.asyncapi.com/?base64=YXN5bmNhcGk6ICcyLjQuMCcKaW5mbzoKICB0aXRsZTogQWNjb3VudCBTZXJ2aWNlCiAgdmVyc2lvbjogMS4wLjAKICBkZXNjcmlwdGlvbjogVGhpcyBzZXJ2aWNlIGlzIGluIGNoYXJnZSBvZiBwcm9jZXNzaW5nIHVzZXIgc2lnbnVwcwpjaGFubmVsczoKICB1c2VyL3NpZ25lZHVwOgogICAgc3Vic2NyaWJlOgogICAgICBtZXNzYWdlOgogICAgICAgICRyZWY6ICcjL2NvbXBvbmVudHMvbWVzc2FnZXMvVXNlclNpZ25lZFVwJwpjb21wb25lbnRzOgogIG1lc3NhZ2VzOgogICAgVXNlclNpZ25lZFVwOgogICAgICBwYXlsb2FkOgogICAgICAgIHR5cGU6IG9iamVjdAogICAgICAgIHByb3BlcnRpZXM6CiAgICAgICAgICBkaXNwbGF5TmFtZToKICAgICAgICAgICAgdHlwZTogc3RyaW5nCiAgICAgICAgICAgIGRlc2NyaXB0aW9uOiBOYW1lIG9mIHRoZSB1c2VyCiAgICAgICAgICBlbWFpbDoKICAgICAgICAgICAgdHlwZTogc3RyaW5nCiAgICAgICAgICAgIGZvcm1hdDogZW1haWwKICAgICAgICAgICAgZGVzY3JpcHRpb246IEVtYWlsIG9mIHRoZSB1c2Vy&readOnly