开发者指令 (高级)

开发文档

叮当猫 API 接口

API接口

注意事项

  • 提交方式全部为Form表单

  • 所有请求必须带auth_secret参数

  • 正常请求速率最高5次/秒

  • 返回格式统一为JSON格式

  • 可查询字段类型:

    • 姓名

    • 身份证

    • 性别

    • 银行卡

    • 邮件地址

    • 密码

    • 各类用户名

    • 微博UID

    • 微信原始ID(WXID)

默认查询

Request

  • Method: POST

  • URL: /api/v1/5500C1337F79BEC6.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    query

    String

    true

    任意查询内容

    张雪

姓名-省市县查询

Request

  • Method: POST

  • URL: /api/v1/6825576C29BE17B3.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    province

    String

    true

    省市县

    河南省郑州市

姓名-省市县-性别-年龄范围查询

Request

  • Method: POST

  • URL: /api/v1/477B937628A5555D.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    province

    String

    true

    省市县

    河南省郑州市

    sex

    String

    true

    性别

    startAge

    int

    true

    开始年龄(大于)

    18

    endAge

    int

    true

    结束年龄(小于)

    20

    开始年龄会自动大于开始年龄并小于结束年龄,如果需要包含开始年龄和结束年龄则需要手动为开始年龄-1并且结束年龄+1

姓名-省市县-性别查询

Request

  • Method: POST

  • URL: /api/v1/65B4A9BE43F2A8CB.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    province

    String

    true

    省市县

    河南省郑州市

    sex

    String

    true

    性别

姓名-省市县-年龄范围查询

Request

  • Method: POST

  • URL: /api/v1/A033EBC91A698419.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    province

    String

    true

    省市县

    河南省郑州市

    startAge

    int

    true

    开始年龄(大于)

    18

    endAge

    int

    true

    结束年龄(小于)

    20

    开始年龄会自动大于开始年龄并小于结束年龄,如果需要包含开始年龄和结束年龄则需要手动为开始年龄-1并且结束年龄+1

模糊姓名查询

Request

  • Method: POST

  • URL: /api/v1/63028169E057AC78.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    wildcardName

    String

    true

    模糊姓名

    张x雪

模糊姓名-性别-生日范围查询

Request

  • Method: POST

  • URL: /api/v1/D13F8553B30CBE01.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    wildcardName

    String

    true

    模糊姓名

    张雪

    sex

    String

    true

    性别

    startBirthday

    int

    true

    开始出生日期(大于)

    19000000

    endBirthday

    int

    true

    结束出生日期(小于)

    20011231

姓名-模糊身份证查询(该接口速度可能会很慢,取决于模糊身份证号码的参数量)

Request

  • Method: POST

  • URL: /api/v1/09B219F8177F9B68.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    wildcardIDCard

    String

    true

    模糊身份证号

    6101xx19920810xxxx

姓名-精确身份证号后四位查询

Request

  • Method: POST

  • URL: /api/v1/AF5F2A9EF703E427.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    end_four

    String

    true

    身份证号后四位

    001X

模糊姓名-模糊身份证号查询

Request

  • Method: POST

  • URL: /api/v1/AA3B29725AF2BFDF.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    wildcardName

    String

    true

    模糊姓名

    张xx

    wildcardIDCard

    String

    true

    模糊身份证号

    6101xx19920810xxxx


姓名-手机号前3位查询

Request

  • Method: POST

  • URL: /api/v1/A6CB1D9EA4BB29EA.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    mobilePrefix

    String

    true

    手机号前3位

    136

姓名-手机号后4位查询

Request

  • Method: POST

  • URL: /api/v1/448DA50144B70064.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    mobileSuffix

    String

    true

    手机号后4位

    0024

模糊姓名-手机号前3位查询

Request

  • Method: POST

  • URL: /api/v1/92E9244750001D39.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    wildcardName

    String

    true

    模糊姓名

    张x雪

    mobilePrefix

    String

    true

    手机号前3位

    136

模糊姓名-手机号后4位查询

Request

  • Method: POST

  • URL: /api/v1/12317AA0341AF956.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    wildcardName

    String

    true

    模糊姓名

    张x雪

    mobileSuffix

    String

    true

    手机号后4位

    0024

姓名-模糊手机号前三位查询

Request

  • Method: POST

  • URL: /api/v1/0F22A86FF729A059.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    wildcardMobilePrefix

    String

    true

    模糊手机号前3位

    13x

姓名-模糊手机号后四位查询

Request

  • Method: POST

  • URL: /api/v1/3574EF7792D53B67.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    wildcardMobileSuffix

    String

    true

    模糊手机号后4位

    0xx4

模糊姓名-模糊手机号前三位查询

Request

  • Method: POST

  • URL: /api/v1/5AE30CBA83152548.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    wildcardName

    String

    true

    模糊姓名

    张x雪

    wildcardMobilePrefix

    String

    true

    模糊手机号前3位

    13x

模糊姓名-手机号后四位查询

Request

  • Method: POST

  • URL: /api/v1/1DC25E0155A2CC12.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    wildcardName

    String

    true

    模糊姓名

    张x雪

    wildcardMobileSuffix

    String

    true

    模糊手机号后4位

    0xx4

姓名-手机号前三位-手机号后四位查询

Request

  • Method: POST

  • URL: /api/v1/81D6124D13B31606.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    mobilePrefix

    String

    true

    手机号前3位

    136

    mobileSuffix

    String

    true

    手机号后4位

    0024

姓名-手机号前三位-模糊手机号后四位查询

Request

  • Method: POST

  • URL: /api/v1/DADD36A5EFA9C351.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    mobilePrefix

    String

    true

    手机号前3位

    136

    wildcardMobileSuffix

    String

    true

    模糊手机号后4位

    0xx4

姓名-模糊手机号前三位-模糊手机号后四位查询

Request

  • Method: POST

  • URL: /api/v1/2BC85B614C15DBBB.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    name

    String

    true

    精确姓名

    张雪

    wildcardMobilePrefix

    String

    true

    模糊手机号前3位

    13x

    wildcardMobileSuffix

    String

    true

    模糊手机号后4位

    0xx4

模糊姓名-模糊手机号前三位-模糊手机号后四位查询

Request

  • Method: POST

  • URL: /api/v1/EB909B2B51F9B8ED.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    wildcardName

    String

    true

    模糊姓名

    张x雪

    wildcardMobilePrefix

    String

    true

    模糊手机号前3位

    13x

    wildcardMobileSuffix

    String

    true

    模糊手机号后4位

    0xx4

模糊姓名-模糊手机号前三位-手机号后四位查询

Request

  • Method: POST

  • URL: /api/v1/3AE3DB8E4741A0D3.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    wildcardName

    String

    true

    模糊姓名

    张x雪

    wildcardMobilePrefix

    String

    true

    模糊手机号前3位

    13x

    mobileSuffix

    String

    true

    手机号后4位

    0024

模糊姓名-手机号前三位-手机号后四位查询

Request

  • Method: POST

  • URL: /api/v1/96F2E894538019AD.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    wildcardName

    String

    true

    模糊姓名

    张x雪

    mobilePrefix

    String

    true

    手机号前3位

    136

    mobileSuffix

    String

    true

    手机号后4位

    0024


手机号 地区搜索

手机号前3位-地区 查询

Request

  • Method: POST

  • URL: /api/v1/3C1498AE89921B1A.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    province

    String

    true

    省市

    河南省郑州市

    mobilePrefix

    String

    true

    手机号前3位

    136

手机号后4位-地区 查询

Request

  • Method: POST

  • URL: /api/v1/3C1498AE89921B1A.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    province

    String

    true

    省市

    河南省郑州市

    mobileSuffix

    String

    true

    手机号后4位

    0024

手机号模糊前3位-地区 查询

Request

  • Method: POST

  • URL: /api/v1/3C1498AE89921B1A.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    province

    String

    true

    省市

    河南省郑州市

    wildcardMobilePrefix

    String

    true

    模糊手机号前3位

    13x

手机号模糊后4位-地区 查询

Request

  • Method: POST

  • URL: /api/v1/3C1498AE89921B1A.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    province

    String

    true

    省市

    河南省郑州市

    wildcardMobileSuffix

    String

    true

    模糊手机号后4位

    0xx4

手机号前3位-后4位-地区 查询

Request

  • Method: POST

  • URL: /api/v1/3C1498AE89921B1A.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    province

    String

    true

    省市

    河南省郑州市

    mobilePrefix

    String

    true

    手机号前3位

    136

    mobileSuffix

    String

    true

    手机号后4位

    0024

手机号模糊前3位-后4位-地区 查询

Request

  • Method: POST

  • URL: /api/v1/3C1498AE89921B1A.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    province

    String

    true

    省市

    河南省郑州市

    wildcardMobilePrefix

    String

    true

    模糊手机号前3位

    13x

    mobileSuffix

    String

    true

    手机号后4位

    0024

手机号前3位-模糊后4位-地区 查询

Request

  • Method: POST

  • URL: /api/v1/3C1498AE89921B1A.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    province

    String

    true

    省市

    河南省郑州市

    mobilePrefix

    String

    true

    手机号前3位

    136

    wildcardMobileSuffix

    String

    true

    模糊手机号后4位

    0xx4

手机号模糊前3位-模糊后4位-地区 查询

Request

  • Method: POST

  • URL: /api/v1/3C1498AE89921B1A.php

  • POST Form

    请求参数
    类型
    必填
    参数说明
    示例

    auth_secret

    String

    true

    身份验证

    Your Secret Key

    province

    String

    true

    省市

    河南省郑州市

    wildcardMobilePrefix

    String

    true

    模糊手机号前3位

    13x

    wildcardMobileSuffix

    String

    true

    模糊手机号后4位

    0xx4

叮当猫HTTP SDK 1.0

项目地址:

https://pypi.org/project/ddc-api-sdk/1.0.5/

使用教程:

Install Package

python3 -m pip install ddc-api-sdk==1.0.5

Used Type

    test_cases = [
        ("高级查询_姓名_模糊身份证查询", "张三", "610101xxxxxxxxxx"),
        ("高级查询_姓名_省市县_年龄范围查询", "李四", "江苏省", 20, 30),
        ("高级查询_姓名_省市县_性别", "王五", "上海市", "男"),
        ("高级查询_姓名_省市县_性别_年龄范围查询", "张伟", "北京市", "男", 25, 35),
        ("高级查询_模糊姓名_性别_生日范围查询", "陈x", "男", "19900000", "20231231"), 
        ("高级查询_模糊姓名_手机号前3位", "刘x", "138"),
        ("高级查询_模糊姓名_手机号后4位", "杨x", "8888"),
        ("高级查询_模糊姓名_模糊手机号前3位", "周x", "138"), 
        ("高级查询_模糊姓名_模糊手机号前3位_模糊后4位查询", "吴x", "138", "8888"), 
        ("高级查询_模糊姓名_模糊手机号前3位_精准后4位查询", "郑x", "138", "8888"),
        ("高级查询_模糊姓名_模糊手机号后4位", "孙x", "8888"),  
        ("高级查询_模糊姓名_模糊身份证查询", "胡x", "110101xxxxxxxx1234"),  
        ("高级查询_模糊姓名_精准手机号前3位_精准后4位查询", "林x", "138", "8888"),
        ("高级查询_模糊姓名查询", "高x"),
        ("高级查询_精确姓名_手机号前3位", "朱明", "138"),
        ("高级查询_精确姓名_手机号前3位_模糊后4位查询", "秦琳", "138", "8888"), 
        ("高级查询_精确姓名_手机号后4位", "许伟", "8888"),
        ("高级查询_精确姓名_模糊手机号前3位", "何婷", "138"), 
        ("高级查询_精确姓名_模糊手机号前3位_模糊后4位查询", "彭磊", "138", "8888"), 
        ("高级查询_精确姓名_模糊手机号后4位", "江涛", "8888"), 
        ("高级查询_精确姓名_省市县", "董芳", "深圳市"),
        ("高级查询_精确姓名_精确手机号前3位_精确后4位查询", "潘晓", "138", "8888"),
        ("高级查询_精确姓名_身份证后四位查询", "袁霞", "1234"),
        ("默认查询", "测试")]

Used Code

from DDCCore.APICore import APICore

if __name__ == '__main__':
    sdk = APICore("https://api.xxxxx.com", "Your API Key")
    data = sdk.高级查询_姓名_省市县_性别_年龄范围查询("杨晓霞", "江苏省", "女", 18, 25)
    data1 = sdk.高级查询_模糊姓名_精准手机号前3位_精准后4位查询("杨xx", "136", "8823")
    print(data)
    print(data1)

成品例子

最后更新于