api-openapi-samples

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #typescript #linux #cli #vue #awesome-list #security #pytorch #mcp #ios #openai

api-openapi-samples

(★ 29)

OpenAPI Samples for the API Ecosystem project.

api-openapi-samples 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# openapi-samples

API samples following given specs.

## Converting swagger to openapi-v3

Just use this online API

https://mermade.org.uk/api/v1/convert?url=$YOUR_URL

eg.

https://mermade.org.uk/api/v1/convert?url=https://sgiauth.azurewebsites.net/explorer/swagger.json

## Converting openapi-v3 to openapi-v2

To convert between formats use:

./bin/api-spec-converter.sh $INFILE -f openapi_3 -t swagger_2 -s yaml  > $OUTFILE

To convert all v3 files to v2, use:

find openapi-v3/ -name \*.yaml \
          -exec bash -c 'I="{}"; ./bin/api-spec-converter.sh "$I" -f openapi_3 -t swagger_2 -s yaml > "${I//v3/v2}" ' \;

## Processing yaml.src

Some specs may be defined using yaml references (eg. to avoid repeating common headers and responses).
While that's valid yaml, explicit is better than implicit. Those files should be *exploded* with:

make yaml

## Generating JSONSchema from existing json

See https://github.com/perenecabuto/json_schema_generator

## API Tools

- SwaggerHub OpenAPI v3, v2 editor https://editor.swagger.io
  - OpenAPI v3, v2 editor by Red Hat https://github.com/apicurio/apicurio-studio
  - openapi-resolver, a python package for creating openapi bundles (resolving $refs and adding them
    as components) and normalize OAS3 files. https://github.com/ioggstream/openapi-resolver

api-openapi-samples

api-openapi-samples 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

api-openapi-samples

api-openapi-samples 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README