/graphql,令牌决定你正在操作谁的账户。
端点
访问令牌由位于
https://oauth-service.fluzapp.com 的独立 OAuth 服务签发。
请求剖析
query— GraphQL 文档。使用具名操作(query GetWallet)以获得更好的日志。variables— 强类型输入,将值从查询字符串中分离。operationName— 可选,当一个文档定义多个操作时很有用。
查询 vs. 变更
- 查询(Queries) 是只读的(
viewer、wallet、transactions)。 - 变更(Mutations) 会改变状态(
createVirtualCard、purchaseGiftCard、depositCashBalance、createTransfer)。
响应格式
GraphQL 始终以 HTTP 200 返回,并包含data / errors 包装:
data 可能为 null,而 errors 将描述问题出在哪里——包括可供分支处理的机器可读 code。参见 错误。
内省与模式
在 Staging 环境启用了内省,你可以将 Apollo Studio 或 GraphiQL 等工具指向该端点。在 Live 环境中,内省被禁用;请改用来自 API 参考 的已发布模式。后续步骤
认证
Authorization 头中的令牌如何被签发——用于你的账户或客户的账户。错误
errors 数组包含什么,以及如何基于错误码进行分支处理。