Обеспечивают ли IBM Bluemix и Azure равную поддержку API Blueprint и OpenAPI? Для описания API

Question

Я мог бы помочь, решив, какой язык описания API использовать для API, которые наша команда развернула в IBM Cloud и, возможно, Azure в будущем.

Мы неофициально использовали API Blueprint, но при регистрации API в Bluemix я заметил, что (и Azure) уже интегрировали OpenAPI. Однако я не знаю, верно ли то же самое для API Blueprint. Я пытался найти что-то, что могло бы помочь решить, каким путем идти, но я не нашел ничего, кроме самих сайтов Blueprint и Swagger.

Я хотел бы знать, являются ли они взаимозаменяемыми в средах Bluemix и Azure, или есть различия между ними, чтобы я мог составить список плюсов и минусов. Учитывая, что мы уже продвинулись с API Blueprint.

Answer 1

Ало,

Примечание: я начинающий, когда дело доходит до Azure.

Спецификация Open API (OAS) поддерживается IBM и Microsoft уже несколько лет или более. Поэтому OAS - это надежная ставка, когда вы работаете с IBM Cloud и Azure. Продукт APIc (локальный или облачный) поддерживает OAS и с самого начала поддерживает swagger (который превратился в OAS).

APIc не поддерживает API Blueprint (вы не можете импортировать файл API Blueprint в APIc).

Из документов Azure я не вижу ссылок на APIBlueprint, которые бы указывали на то, что вы не можете импортировать определенные ресурсы API Blueprint.

Я вижу ссылку на сваггер /OAS здесь, но не на API Blueprint в контексте импорта определений API.