【发布时间】:2022-08-22 16:27:41
【问题描述】:
有什么方法可以分享异步API与他人的文件?我使用AsyncAPI Studio 来编写我的 API 文档。但是我在 AsyncAPI studio 中找不到共享选项。 AsyncAPI Studio/任何其他 AsyncAPI 编辑器中是否有一种方法可以用来与他人共享我们的 API 文档?
在SwaggerHub,我们可以与其他人分享我们使用 OpenAPI 规范编写的 rest api 文档。
有什么方法可以分享异步API与他人的文件?我使用AsyncAPI Studio 来编写我的 API 文档。但是我在 AsyncAPI studio 中找不到共享选项。 AsyncAPI Studio/任何其他 AsyncAPI 编辑器中是否有一种方法可以用来与他人共享我们的 API 文档?
在SwaggerHub,我们可以与其他人分享我们使用 OpenAPI 规范编写的 rest api 文档。
是的,你有这种可能性,但有限。 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
【讨论】: