客服支持API

通过脚本或AI智能体联系Litport客服：发起对话、添加消息，并通过轮询读取回复。

litport.net/support上的聊天组件会要求用户完成验证码，因此脚本或智能体应改用此API或邮件。

基础URL：

https://litport.net/api/v1/support

调用#

发送JSON并带上Content-Type: application/json。响应为JSON。

两种调用方式#

无账户（访客）：发送email和message，不带Authorization请求头。响应中会包含以lsc_开头的accessToken。在另外两个调用中，将其作为Authorization: Bearer lsc_…发送。该令牌只在该响应中显示一次，请妥善保存。它只能打开为其签发的那个对话。访客对话可以回答一般性问题：位置、价格、配置。

使用账户API密钥：发送Authorization: Bearer lit_…（在设置中创建密钥；参见Litport API）。这样调用会进入您账户的对话，客服就可以讨论您的订单和代理。一个账户只有一个对话：再次POST /conversations会向同一个对话添加消息，email会被忽略。

访问令牌和API密钥使用同一个Authorization: Bearer …请求头。不要把任何一个放入URL中。

发起对话#

curl -sS 'https://litport.net/api/v1/support/conversations' \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","message":"Which countries do you cover with mobile proxies?","name":"Research agent"}'

响应（201）：

{
  "conversationId": "4f0c2a7e9b1d4c5a8e3f6a1b2c3d4e5f",
  "accessToken": "lsc_example_token_returned_once",
  "identity": "guest",
  "howToUpgrade": "This is a guest conversation, so we can only answer general questions here. For help with your orders or proxies, call this API with your account API key (Authorization: Bearer <key>), or email [email protected] from your account address.",
  "message": {
    "seq": 1,
    "at": "2026-10-16T17:05:00.000Z",
    "author": "you",
    "text": "Which countries do you cover with mobile proxies?",
    "files": []
  }
}

identity为guest或account。对于访客，howToUpgrade说明如何获得订单和代理方面的帮助。使用API密钥时，accessToken和howToUpgrade为null，identity为account；请继续发送API密钥。

添加消息#

export LITPORT_SUPPORT_TOKEN='lsc_the_token_from_the_first_response'
curl -sS "https://litport.net/api/v1/support/conversations/$CONVERSATION_ID/messages" \
  -H "Authorization: Bearer $LITPORT_SUPPORT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"message":"Thanks. Do you have mobile proxies in Texas?"}'

响应（201）：

{
  "message": {
    "seq": 2,
    "at": "2026-10-16T17:06:12.000Z",
    "author": "you",
    "text": "Thanks. Do you have mobile proxies in Texas?",
    "files": []
  }
}

读取对话#

curl -sS "https://litport.net/api/v1/support/conversations/$CONVERSATION_ID?after=2" \
  -H "Authorization: Bearer $LITPORT_SUPPORT_TOKEN"

after是您已有的最大seq。省略它则从头开始读取。

{
  "conversationId": "4f0c2a7e9b1d4c5a8e3f6a1b2c3d4e5f",
  "identity": "guest",
  "howToUpgrade": "This is a guest conversation, so we can only answer general questions here. For help with your orders or proxies, call this API with your account API key (Authorization: Bearer <key>), or email [email protected] from your account address.",
  "lastSeq": 3,
  "waitingOn": "customer",
  "messages": [
    {
      "seq": 3,
      "at": "2026-10-16T17:09:40.000Z",
      "author": "mike",
      "text": "Thanks, I'm checking this now and will reply here.",
      "files": []
    }
  ],
  "more": false,
  "pollAfterSeconds": 30
}

author对您自己发送的消息为you，对客服的回复为mike，对简短通知为system。mike回复的文本可以用Markdown双星号把少数短语标为粗体（**like this**）；文本中的其他内容都不是Markdown。files只列出name和kind。API不支持附件，也没有下载链接。

回复不是即时的，也不会推送给您。请每隔30秒重新读取一次对话，直到收到mike的消息。一次读取即视为已读取它返回的每条消息。访客对话中的每条回复也会立即通过邮件发送到您提供的地址，回复该邮件即可继续对话。在账户的对话中，如果回复保持未读状态达2分钟，则会通过邮件发送到账户的邮箱地址。

限制#

超出限制时返回429 RATE_LIMITED。超出限制的读取还会返回Retry-After。请等待该时长后再进行下一次调用。

错误#

错误使用与API其余部分相同的格式：

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Conversation not found.",
    "requestId": "req_example",
    "docsUrl": "https://litport.net/docs/api/support"
  }
}

X-Request-ID响应头与requestId携带相同的ID；报告问题时请附上。

MCP工具#

Litport MCP服务器有三个客服支持工具：

没有LITPORT_API_KEY时，它们作为访客对话运行，服务器会在会话期间将访问令牌保存在内存中。设置了LITPORT_API_KEY时，它们使用您账户的对话。

邮件#

您也可以写信到[email protected]。如需订单或代理方面的帮助，请使用您的Litport账户邮箱地址发送。