Skip to main content

Connection Information

Connection Address: ws://127.0.0.1:23188

Communication Protocol

Request Format Client sends JSON format requests:
Field Description:
  • type (string): API method name
  • evtid (string): Unique event ID for matching requests and responses
  • timeout (number): Timeout in seconds, optional, supported by some interfaces
  • Other parameters depend on the specific API method
Response Format Server returns two formats: 1. JSON Format Response (Regular Data):
2. Binary Format Response (Contains Binary Data): Binary data format: [6-byte metadata length][metadata JSON][binary data]
  • First 6 bytes: UTF-8 encoded metadata length string
  • Metadata: JSON format response information
  • Binary data: Actual binary content
Error Response
Server Event Push Events actively pushed by the server:
📢 Event Notifications See Event Notifications for all available event types and detailed descriptions

Client Implementation

We provide WebSocket client implementation examples for multiple programming languages to help you quickly integrate with iClick API: 📚 Multi-language Support See Multi-language Client Implementation for complete client code examples