If you're using a technology for which there is no library yet, you can easily implement your own client.
See these two blog posts about creating a client:
- Generating a Zeebe-Python Client Stub in Less Than An Hour: A gRPC + Zeebe Tutorial
- Writing a Zeebe Client in 2020
There are two essential steps:
- Authentication via OAuth
- GRPC handling
OAuth is a standard authentication procedure. For an access token, you execute a POST request to the Auth URL with the following payload:
Here you see an example of a request with
curl, which gives you an access token with given client credentials (don't forget to set the environment variables before):
You'll receive an Access Token in the following format:
This token is valid for 86400 seconds (24 hours). Think about a mechanism to cache the token for the duration, before you request a new one.
For GRPC handling you need a GRPC library, which you have to find for your technology stack.
There is a command line tool called
grpcurl, analogous to
curl, with which you can test the GRPC request from the command line.
Install grpcurl (for example, by using npm):
Now request an access token (as in the first step) and filter out the access token. Write the value for follow-up processing into a variable:
For the GRPC call you now need a proto buffer file (you can find it in the zeebe.io repository):
Copy the Cluster Id of your Zeebe cluster (you can find it on the cluster detail view). Now you have all data together to execute the GRPC call and get the status (change the cluster id variable with your own cluster id):
You should now get a similar result: