Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marcelojaloto/swagdoc
Create a public documentation REST API using Swagger 2.0 for Delphi.
https://github.com/marcelojaloto/swagdoc
api delphi documetation firemonkey library open-api rest swagger vcl
Last synced: about 5 hours ago
JSON representation
Create a public documentation REST API using Swagger 2.0 for Delphi.
- Host: GitHub
- URL: https://github.com/marcelojaloto/swagdoc
- Owner: marcelojaloto
- License: apache-2.0
- Created: 2018-02-28T19:45:14.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-06-15T14:56:21.000Z (over 1 year ago)
- Last Synced: 2024-10-01T00:03:55.335Z (about 1 month ago)
- Topics: api, delphi, documetation, firemonkey, library, open-api, rest, swagger, vcl
- Language: Pascal
- Homepage:
- Size: 821 KB
- Stars: 98
- Watchers: 25
- Forks: 33
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SwagDoc
SwagDoc is a Delphi library to generate swagger.json file for Swagger Spec version 2.0. Create a public documentation REST API using Swagger 2.0 for Delphi Language. SwagDoc's only responsibility is to generate the swagger.json file. The swagger.json file is responsible for containing all the documentation for your REST API. This file must be attached to the Swagger UI (User Interface) files.
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=AW8TZ2QTDA7K8)
## Swagger (Open API) - version 2.0
SwagDoc follows the specification 2.0 because it is more popular in the market and also because it is considered a more stable version to exist the longest. SwagDoc does not yet support the Swagger 3.0 version, but depending on the demand and contributions to the project it may evolve to support spec 3.0.
The main prerequisite for working with SwagDoc is to know the Swagger 2.0 specification that can be viewed in the link below.
https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
https://swagger.io/docs/specification/2-0/basic-structure/
When creating a Swagger documentation for your REST API you can produce a page like the following example.
https://app.swaggerhub.com/apis-docs/swagdoc/sample-api/v1
## Json Schema
https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#schemaObject
http://json-schema.org
## SwagDoc Speeches
https://www.youtube.com/watch?v=9U3HP3B5UT0 (Pt-Br)
https://www.youtube.com/watch?v=PhgMQAd8O6c (Pt-Br)
## Swagger References and Tutorials
https://swagger.io/swagger/media/blog/wp-content/uploads/2017/02/Documenting-An-Existing-API-with-Swagger-2.pdf
https://idratherbewriting.com/learnapidoc/pubapis_swagger_intro.html
## Swagger Tools
- Swagger:
https://swagger.io
- Swagger Editor:
https://editor.swagger.io
- Swagger Hub:
https://swagger.io/tools/swaggerhub
- The classic swagger sample:
http://petstore.swagger.io
- Tools and Integrations:
https://swagger.io/tools/open-source/open-source-integrations
## Swagger UI distribution files
For you to produce a page containing a Swagger documentation you need the Swagger UI distribution files.
These files you can find in the github swagger-api / swagger-ui repository.
https://github.com/swagger-api/swagger-ui/tree/master/dist
First you need to download the swagger user interface files and generate the swagger.json file. You then need to change the index.html file to indicate the relative path of the location where the swagger.json file is located on your web server that is hosting the swagger user interface files.
See an example below.
