Docs on using the API

[bigkevmcd]

We need some examples of how to talk to the the weave-gitops-enterprise API server using curl and possibly Python/JavaScript.

[bigkevmcd]

We should provide examples for the following:

Authenticating via a Curl request (using -c and -b) querying resources.

Using https://github.com/pyopenapi/pyswagger and requests in Python

Authenticating via the fetch API

All these for both the static credentials (in the secret) and using OIDC ID Tokens

[foot]

Can we avoid the payload type in the protobuf files and our server responses?

[foot]

@steve-fraser ! What are the main api use cases?

• I would guess for listing things kubectl get ... is nicer.
• flux suspend / resume / sync
• gitops create template to render templates?

[foot]

Either way, want a few examples on how to do some querying.

• list things
• render template (github auth token etc)
• Base example https://gist.github.com/bigkevmcd/928043f27b1c68c2b41750b1e0c14c92
• OIDC flow? Some python/etc library to do that dance?