Swagger doc would be nice

EventStoreDB
#1

I have a feeling this has already been done, but saw no evidence of it out there.

Anyone use one?

The application for me would be the possible use of setting up a proxy in Apigee in front of EventStore.

Why you ask would I want to do this? That remains to be seen, but some reasons include:

  • to have some policies in place to prevent event posts without the proper structures

  • caching (perhaps)

  • authentication gateway (which may be required)

#2

How would setting up a proxy in front of eventstore be any different than any other source?

There used to be some docs regarding varnish/nginx IIRC. OK I bit and went to find them https://github.com/EventStore/EventStore/wiki/Setting-Up-Varnish-In-Linux

The problem is the docs are nothing to do with eventstore.

#3

Thanks Greg for your reply.

Varnish may be fine, but I am also interested in the possibility of Apigee.

So the request is not over the right proxy to use, but simply if someone here has written a swagger.yaml file that ties to the /streams and /projections endpoints of ES.

If not, I will write as time permits. :slight_smile:

#4

If you do please post it :slight_smile:

#5

PR to repo best route?

#6

:+1:

#7

Hey Andre,

Did you ever create the Swagger file? I’m helping the Event Store team overhaul the docs, and for various reasons I also want to create a Swagger file, if you started one already then it would save me some time. If not, well, there will be one soon :slight_smile:

#8

Not as of yet. 50-50 if I can get to it in January

#9

No worries, I started one, will get it to GitHub soon and we can collaborate on it.

Chris