按跟进关系创建时间升序列出已跟进的客户

列出的客户指探马_CRM_客户。因存在非好友客户和删除客户、放弃&回收客户到公海等情景，该列表与企微“我的客户”列表可能不同。只列出作为负责人跟进的客户，作为协作人跟进的客户不会列出。客户字段类型参见客户&线索字段类型

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

since

string

指定时间段开始时间（包含）

必需

格式 yyyy-MM-dd HH:mm:ss，开始和结束时间相差不应超过一个月

before

string

指定时间段结束时间（不包含）

可选

格式 yyyy-MM-dd HH:mm:ss。如果未指定表示到当前时间。开始和结束时间相差不应超过一个月

type

integer

类型

可选

1 个人客户 2 企业客户其他或不传表示不限定

qwUserId

string

销售企微账号。不传不限定

可选

size

integer

获取数量

可选

默认100。最大10000

cursor

string

游标

可选

示例

{
  "since": "2013-04-17 20:33:09",
  "qwUserId": "elit magna",
  "size": 100,
  "type": 1,
  "before": "2018-08-15 00:35:37",
  "cursor": "in ea consequat"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

message

string

结果说明

必需

data

object

客户列表页

必需

list

array [object {15}]

客户列表

必需

nextCursor

string

游标

必需

如果游标为空，表示没有下一页了

示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "list": [
      {
        "customerId": 414912243411008,
        "qwUserId": "dowen",
        "type": 1,
        "fields": [
          {
            "field": "customer_source",
            "type": 2,
            "valueAsText": null
          },
          {
            "field": "description",
            "type": 1,
            "valueAsText": null
          },
          {
            "field": "mobile",
            "type": 8,
            "valueAsText": "[\"18809890987\"]"
          },
          {
            "field": "address",
            "type": 1,
            "valueAsText": null
          },
          {
            "field": "birthday",
            "type": 3,
            "valueAsText": null
          },
          {
            "field": "corp_name",
            "type": 1,
            "valueAsText": null
          },
          {
            "field": "name",
            "type": 1,
            "valueAsText": "客户A3ooIc"
          },
          {
            "field": "purchase_intention",
            "type": 2,
            "valueAsText": null
          },
          {
            "field": "gender",
            "type": 2,
            "valueAsText": "0"
          },
          {
            "field": "customer_stage",
            "type": 2,
            "valueAsText": "401244899840064"
          }
        ],
        "tagIds": [],
        "createTime": "2021-06-02 20:04:41",
        "lastUpdateTime": "2021-06-02 20:04:41",
        "wechatNickname": null,
        "wechatAvatar": null,
        "wechatLocation": null,
        "convertCustomerTime": null,
        "qwRemark": "客户A3ooIc",
        "externalUserId": null
      },
      {
        "customerId": 416156789723200,
        "qwUserId": "dowen",
        "type": 2,
        "fields": [
          {
            "field": "customer_source",
            "type": 2,
            "valueAsText": null
          },
          {
            "field": "description",
            "type": 1,
            "valueAsText": ""
          },
          {
            "field": "mobile",
            "type": 8,
            "valueAsText": "[]"
          },
          {
            "field": "address",
            "type": 1,
            "valueAsText": null
          },
          {
            "field": "birthday",
            "type": 3,
            "valueAsText": null
          },
          {
            "field": "corp_name",
            "type": 1,
            "valueAsText": null
          },
          {
            "field": "name",
            "type": 1,
            "valueAsText": null
          },
          {
            "field": "purchase_intention",
            "type": 2,
            "valueAsText": null
          },
          {
            "field": "gender",
            "type": 2,
            "valueAsText": "1"
          },
          {
            "field": "customer_stage",
            "type": 2,
            "valueAsText": "401244899840064"
          }
        ],
        "tagIds": [],
        "createTime": "2021-06-09 20:52:58",
        "lastUpdateTime": "2021-06-09 20:52:58",
        "companyInfo": {
          "id": 416156782616640,
          "name": "考虑考虑"
        },
        "wechatNickname": "dong",
        "wechatAvatar": "https://wx.qlogo.cn/mmhead/Q3auHgzwzM79SIfrfXkGZWcLiczyiaGOLFHmOW01oysQiaM8NOtBc8QVQ/0",
        "wechatLocation": null,
        "convertCustomerTime": null,
        "qwRemark": "dong",
        "externalUserId": null
      }
    ],
    "nextCursor": "AAAAAGDAuaoAAAAALLJOeAAAAAADf7ZB"
  }
}

🟢200异常