Ideas for improving the new policy probes feature

[msavy]

In Apiman 3, a new feature called 'policy probes' has been introduced.

This allows developers to probe the state of a policy.

For example, a web application could ask what the current rate limiter state is for a given user/policy.

Policy implementors can decide exactly how their probe(s) work. They just need to implement a few interface methods and decide what their request and response payloads should look like.

Here's an example in Apiman Rate Limiting:

https://github.com/apiman/apiman/blob/master/gateway/engine/policies/src/main/java/io/apiman/gateway/engine/policies/RateLimitingPolicy.java#L199-L216

In this discussion thread, please give your feedback, ideas, etc.