Mermade Swagger2OpenAPI Converter

What authentication does the Swagger2OpenAPI Converter use?

The hosted service does not declare a security scheme; the documented endpoints are publicly callable. Through Jentic, calls are still routed through the gateway so tenants get logging and request shaping even when the upstream is unauthenticated.

Can I send the Swagger spec directly in the body instead of by URL?

Yes. POST /convert accepts the Swagger 2.0 definition in the request body and POST /validate accepts an OpenAPI 3.0.x definition the same way, which is useful when the spec is not yet published at a public URL.

What are the rate limits for the Swagger2OpenAPI Converter?

The OpenAPI spec does not declare rate limits. The hosted service is community-run on a single host, so high-volume callers should self-throttle and prefer the npm package swagger2openapi for batch jobs rather than calling the API in a tight loop.

How do I convert a Swagger 2.0 spec through Jentic?

Install the SDK with pip install jentic, search for 'convert Swagger 2.0 to OpenAPI 3.0', load the POST /convert operation, and execute it with the Swagger JSON in the body. Jentic returns the converted OpenAPI 3.0.x payload.

Does the converter return validation errors when the input is broken?

Yes. POST /validate returns a structured error response listing the schema violations found, so callers can use it to gate CI pipelines or fail a publish step when the underlying spec is invalid.