Some of Velocidi's API's are available through a gRPC interface. In particular, both the Event Storage and User Profile Storage modules provide gRPC interfaces, giving you access to the systems' captured user events and user attributes.
In order to access Velocidi's API's through gRPC you need to be aware of the available endpoints:
These endpoints might not be open. If so, contact our support
To quickly experiment with the gRPC APIs from the Velocidi Private CDP the grpc_cli utility can be installed, which provides a terminal utility to call methods from any gRPC server.
In MacOS X this can be installed with:
With this utility, one is fully capable of interacting with any standard gRPC server.
For example, to list all the available services and methods on a
$ grpc_cli ls events.example.com:8888
Below, we use the
trackingEventsSource method to retrieve a list of user events within a given time range:
Some of the gRPC methods provided by the Event Storage module accept a single string parameter
query. This parameter represents a query string in AOQL
language. AOQL tries to abstract some of the differences between the storage infrastructure of
different events types while providing a common set of operations that can be used to query all different events.
For example, here is the previous
trackingEventsSource query now executed using an AOQL query string:
Please refer to the AOQL documentation for details on its usage.