Is it possible to get a Swagger v2.0 definition file of the Self-Hosted Laserfiche API? I am working on creating a custom connector for Microsoft Power Automate and it does not support v3.0 out of the box.
Question
Question
Swagger v2.0 Definition of Self-Hosted Laserfiche API?
Answer
Laserfiche APIs do NOT and will NOT support the generation of Swagger v2.0 definition file. Currently Laserfiche APIs supports Openapi v3 definition file.
That said, I did a quick code change to see if it was even possible and attached the resulting "swagger": "2.0" file. I don't know if it's any good. See comments at the top of the file:
// Copyright Laserfiche.
// Licensed under the MIT License.
// THIS "swagger": "2.0" DEFINITION IS NOT SUPPORTED OR TESTED BY LASERFICHE. USE AT YOUR OWN RISK.
If after all this warnings you choose to proceed. Let us know...
Replies
I've forwarded this request to the team.
In this Microsoft thread Custom Connector import using Open API 3.0, someone commented:
Workaround: I made Open API 3 spec, made it into a postman collection and then created the custom connector with the postman collection. Custom connector allows Postman collection import even if it has a Open API spec 3 file. This longer workflow is good enough for me temporarily. clearly the permanent solution is for MS to support import of Open API 3 spec YAML.
Presumably referencing this option: Learn > Power Platform > Connectors
Create a custom connector from a Postman collection
That's another route you could try.
Edit: I generated and attached Postman Collection (v2.1) files from the Laserfiche OpenAPI 3.0 spec.
Edit 2: Power Automate only supports Postman Collection v1 files, which are no longer supported by Postman and cannot be generated from the Postman client any more. There are 3rd party methods and tools to convert v2 Collections to v1. This has been an open issue for three years: Deprecate Postman v1 and allow import of Postman v2/v2.1 for Custom Connectors | Custom connector using Postman collection v.2 - is it possible?
Great job on your premier integration platform, Microsoft.
Edit 3: Someone on the Power Apps forum said "Yes, support for Postman Collection v2 is available as of Oct 2021." and in a different thread someone else showed a screenshot of a Power Platform interface that says "Import a postman collection (V1, V2.0, or V2.1)".