Holger Reinhardt

I have tried to make this more prominent. Can you check if it works for you.

https://developer.github.com/webhooks/ https://developer.github.com/v3/repos/hooks/ https://www.shipwire.com/w/developers/webhooks-guide/ https://engineering.shopify.com/17488672-webhook-best-practices http://phalt.co/webhooks-in-apis/ https://coffeeonthekeyboard.com/best-practices-for-happy-webhooks-1138/

I would love to know why?! I had assumed that trying to design a better API by soliciting input and review would be something inherently meaningful and valuable to engineers....

Also add perspective of API user 'outside-in' design http://www.kennethlange.com/posts/7_tips_for_designing_a_better_rest_api.html

Exploring Kubernetes I stumbled over their very promising format. `MacBook-Air-4:~ h_reinhardt$ kubectl proxy Starting to serve on 127.0.0.1:8001` Navigate to the root of the Url and you receive a json...

[root.json.txt](https://github.com/Haufe-Lexware/api-style-guide/files/948893/root.json.txt) [api.json.txt](https://github.com/Haufe-Lexware/api-style-guide/files/948894/api.json.txt) [apis.json.txt](https://github.com/Haufe-Lexware/api-style-guide/files/948895/apis.json.txt) [swaggerapi.json.txt](https://github.com/Haufe-Lexware/api-style-guide/files/948896/swaggerapi.json.txt)

Here are some links I found, but little about the thoughts behind the API format https://thenewstack.io/taking-kubernetes-api-spin/ https://kubernetes.io/docs/reference/api-overview/ https://kubernetes.io/docs/admin/kube-apiserver

What really appeals to me is the notion of having an endpoint document at the root and the subsequent ability to introspect APIs

@DonMartin76 - I would really like to explore the API discovery feature together with Wicked. Like in K8s I would like to be able to retrieve an endpoint document which...

dret [3:12 PM] if you're interested in teaming up, definitely let me know, @holger. i have started focusing a bit of energy into this space, and plan on spending quite...