EVE-Tools / element43

Market, Trade and Industry Manager for EVE Online
BSD 3-Clause "New" or "Revised" License
81 stars 25 forks source link

Add OpenAPI docs and UI for our APIs #45

Open zweizeichen opened 6 years ago

zweizeichen commented 6 years ago

Now that we have switched to gRPC for our cluster's internal communication we can generate OpenAPI docs by using grpc-gateway on which jumpgate is based. The individual service's Protobuf annotations are there, we just need to combine the individual generated Swagger docs using something like swagger-combine and package them up for deployment with swagger-ui. We may even be able to use parts of esi-swagger-ui so our docs would look like ESI's documentation.