环境

API 根据操作类型使用两个不同的端点：用于查询和 mutation 的 HTTPS URL，以及用于 subscription 的 WebSocket (WSS) URL。

端点

查询和 mutation

查询和 mutation 通过 HTTP POST 请求发送到主 GraphQL 端点。

https://api.chargetrip.io/graphql

Subscription

Subscription 需要通过 WebSocket 建立持久连接，可以使用 graphql-transport-ws 协议来实现。

wss://api.chargetrip.io/subscription

Server-Sent Events

Server-Sent Events (SSE) 是 WebSocket 之外接收实时更新的另一种方式。它不是一种 subscription 类型，而是一种不同的消息传输方式：它通过常规 HTTP 连接而不是持久的 WebSocket 来流式传输 subscription 结果。

https://subscription.chargetrip.io/sse

授权请求头

在每个请求中添加以下请求头。标记为必填的请求头必须始终发送。

x-client-id · 必填

包含项目配置的项目 ID。

x-app-id · 必填

用于安全和拆分分析的应用 ID。

x-app-identifier

iOS 或 Android 的包标识符。

x-app-fingerprint

Android SHA 指纹。

发送已授权的请求

默认情况下，每个项目都会生成一个唯一的 x-app-id。

curl -X POST \  -H "Content-Type: application/json" \  -H "x-client-id: YOUR_KEY_HERE" \  -H "x-app-id: YOUR_KEY_HERE" \  -d '{ "query": "{ } " }' \  https://api.chargetrip.io/graphql