Skip to main content

Overview

Introduction​

Raccoon provides a suite of client libraries designed to help developers easily send clickstream events to its low-latency, high-throughput event ingestion service. Whether you’re building real-time analytics, tracking user behavior, or processing large-scale event data, Raccoon's clients offer flexible and efficient integration via WebSocket, REST, and gRPC APIs.

Key Features​

  • Multi-Protocol Support: WebSocket, REST, and gRPC are available in all clients, allowing you to choose the best fit for your application’s needs.
  • Ease of Integration: Designed with simplicity in mind, the clients integrate easily into existing projects with minimal configuration.
  • Reliability: Each client includes retry mechanisms and error handling to ensure events are delivered reliably, even in the face of transient failures.

Wire and Serialization Types​

A concept that exists in all Raccoon Client libraries is that of wire type and serialization type.

Raccoon's API accepts both JSON and Protobuf requests. These are differentiated by the Content-Type header (in case of REST & gRPC protocols) and by MessageType for Websocket requests.

Wire denotes what the request payload is serialised as. If wire type is JSON the request is sent as a JSON-encoded string. If it's Protobuf the request is the serialized bytes of SendEventRequest proto

Serialization is how data in individual events is encoded. Just like wire type, it also supports JSON and Protobuf encoding.

You may use any combination of wire and serialization type that suits your needs.

Getting Started​

To start using Raccoon's client libraries, check out the detailed installation and usage instructions for each supported language:

By leveraging Raccoon’s clients, you can focus on building your applications while Raccoon efficiently handles the ingestion of your clickstream events.