文档中心 / CSDN

CSDN 对接示例

分组CSDN 入口返回首页

CSDN 对接示例支持直接在线查看、复制和下载源码,无需再下载压缩包。

对接示例

按语言环境展开查看代码,支持直接复制和下载源码。

Python

共 2 个示例,按接口动作拆分。

该语言注意事项

跟随当前语言展示
  • ============================================================== CSDN识别 对接示例 — Python版 使用说明 ============================================================== 【一、环境准备】 1. 安装 Python - 下载地址:https://www.python.org/downloads/ - 建议版本:Python 3.6 或以上(推荐 3.8+) - 安装时务必勾选 "Add Python to PATH"(添加到系统环境变量) - 安装完成后,打开命令行(cmd 或 PowerShell),输入以下命令验证: python --version 如果显示类似 "Python 3.x.x" 则安装成功 2. 安装依赖库 requests - 打开命令行,执行: pip install requests - 如果 pip 速度慢,可以使用国内镜像源: pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple - 安装完成后,可以用以下命令确认: pip show requests 看到版本号即表示安装成功 -------------------------------------------------------------- 【二、参数配置】 本Demo包含两个独立脚本: - query_points.py — 查询账户剩余点数 - recognize_csdn.py — 提交CSDN验证码识别 请根据需要打开对应的脚本文件,找到顶部的"配置区域",修改以下参数: 1. APPKEY(必填) - 你的用户密钥,登录平台后在个人中心获取 - 示例:APPKEY = "abc123def456" 2. CSDN_COOKIE(必填) - CSDN验证码的 waf_captcha_marker cookie字段值 - 需要从浏览器开发者工具(F12)中获取 - 打开浏览器 → F12 → Application/应用 → Cookies → 找到 waf_captcha_marker 字段 - 示例:CSDN_COOKIE = "39f8d06301c63ecc990e..." 3. ITEM_ID(一般不需要改) - CSDN类型固定填写 600 - 特殊类型请联系客服确认 4. PROXY(可选) - 如果你需要通过代理IP访问,填写代理地址 - 支持的格式: * http://IP:端口 (普通HTTP代理,若需白名单支持请联系客服) * http://账号:密码@proxy.com:8080 (带认证的HTTP代理) * socks5://127.0.0.1:9888 (SOCKS5代理) - 不需要代理则留空:PROXY = "" 5. DEVKEY(可选) - 开发者密钥,如果你有的话填写,没有则留空 6. UA(可选) - User-Agent值,如果需要的话填写,没有则留空 -------------------------------------------------------------- 【三、运行方式】 1. 打开命令行(cmd 或 PowerShell) 2. 切换到脚本所在目录: cd CSDN\python 查询点数: 3. 执行:python query_points.py - 仅查询账户剩余点数,确认APPKEY是否正确 CSDN识别: 4. 执行:python recognize_csdn.py - 提交CSDN验证码识别任务,等待服务器返回结果 5. 识别结果会在控制台中显示 -------------------------------------------------------------- 【四、常见问题】 Q1:运行时提示 "ModuleNotFoundError: No module named 'requests'" A1:说明 requests 库未安装,请执行 pip install requests Q2:运行时提示 "请先在脚本顶部的配置区域填写你的 APPKEY" A2:你还没有修改 APPKEY,请用你自己的密钥替换 "你的appkey" Q3:查询点数成功但识别失败 A3:请检查 CSDN_COOKIE 是否正确,cookie值需要实时获取 Q4:返回的结果无法通过验证 A4:尝试对返回的 data 值进行 URL编码(urlencode)后再使用 Q5:识别耗时较长(超过10秒) A5:这是正常现象,验证码识别需要服务器端处理,耐心等待即可 Q6:提示网络请求出错 A6:请检查网络连接是否正常,或者尝试使用代理IP -------------------------------------------------------------- 【五、重要注意事项】 1. 查询点数接口有频率限制:不得超过1秒1次,否则会被拉黑24小时 2. 识别接口的超时时间设置为60秒,请耐心等待结果 3. 不要将你的 APPKEY 泄露给他人 4. 请确保你的账户有足够的点数余额 5. 目前CSDN识别支持文字点选,若需其他类型请联系客服 6. 如果提交结果失败无法通过,请将结果URL编码后提交 ==============================================================

查询点数

query_points.py

下载源码
query_points.py

Python

# -*- coding: utf-8 -*-
"""
=============================================================
  查询账户点数 Demo (Python版)

  功能说明:
  查询账户剩余点数(余额)

  使用方法:
  1. 安装依赖:pip install requests
  2. 将下方的 APPKEY 替换为你自己的用户密钥
  3. 运行脚本:python query_points.py
=============================================================
"""

import requests
import json
import sys

# ======================== 配置区域(请替换为你自己的参数)========================
# 用户密钥,登录平台后获取
APPKEY = "你的appkey"
# ===============================================================================

# API基础地址
API_BASE = "http://api.ttocr.com/api"


def query_points():
    """
    查询账户剩余点数
    接口地址:GET http://api.ttocr.com/api/points
    注意:查询点数不得超过1秒1次,否则会被拉黑24小时
    """
    print("=" * 50)
    print("[查询点数] 正在查询账户剩余点数...")
    print("=" * 50)
    url = f"{API_BASE}/points"
    params = {"appkey": APPKEY}
    try:
        response = requests.get(url, params=params, timeout=10)
        result = response.json()
        if result.get("status") == 1:
            print(f"[成功] 查询成功!当前可用点数:{result.get('points')}")
        else:
            print(f"[失败] 查询失败,错误信息:{result.get('msg')}")
            print(f"[提示] 错误状态码:{result.get('status')},请参考错误代码表排查")
        print(f"[完整响应] {json.dumps(result, ensure_ascii=False, indent=2)}")
        return result
    except requests.exceptions.RequestException as e:
        print(f"[异常] 网络请求出错:{e}")
        return None


if __name__ == "__main__":
    print("*" * 60)
    print("  查询账户点数 Demo (Python版)")
    print("*" * 60)
    if APPKEY == "你的appkey":
        print("\n[错误] 请先在脚本顶部的配置区域填写你的 APPKEY")
        sys.exit(1)
    query_points()
    print("\n" + "=" * 50)
    print("[完成] 查询执行完毕")
    print("=" * 50)

提交识别

recognize_csdn.py

下载源码
recognize_csdn.py

Python

# -*- coding: utf-8 -*-
"""
=============================================================
  CSDN识别 Demo (Python版)

  功能说明:
  提交CSDN验证码识别任务(目前支持文字点选)

  使用方法:
  1. 安装依赖:pip install requests
  2. 将下方的 APPKEY 替换为你自己的用户密钥
  3. 将 CSDN_COOKIE 替换为你获取到的 waf_captcha_marker cookie值
  4. 运行脚本:python recognize_csdn.py
=============================================================
"""

import requests
import json
import sys

# ======================== 配置区域(请替换为你自己的参数)========================
# 用户密钥,登录平台后获取
APPKEY = "你的appkey"

# CSDN验证码的 waf_captcha_marker cookie字段值(从浏览器抓包获取)
CSDN_COOKIE = "你获取到的cookie"

# 项目类型,CSDN固定填写 600(特殊类型请联系客服)
ITEM_ID = 600

# 可选参数:代理IP(格式示例:http://IP:端口,若需白名单支持请联系客服。http://账号:密码@proxy.com:8080 或 socks5://127.0.0.1:9888)
PROXY = ""

# 可选参数:开发者密钥(如果有的话填写)
DEVKEY = ""

# 可选参数:User-Agent(如果需要的话填写)
UA = ""
# ===============================================================================

# API基础地址
API_BASE = "http://api.ttocr.com/api"


def recognize_csdn():
    """
    提交CSDN验证码识别任务
    接口地址:POST http://api.ttocr.com/api/recognize2
    必填参数:appkey, cookie, itemid(固定600)
    可选参数:proxy, devkey, ua
    重要提示:如果提交结果失败无法通过,请将结果URL编码后提交
    """
    print("=" * 50)
    print("[CSDN识别] 正在提交CSDN识别任务...")
    print("=" * 50)
    url = f"{API_BASE}/recognize2"
    post_data = {
        "appkey": APPKEY,
        "cookie": CSDN_COOKIE,
        "itemid": ITEM_ID,
    }
    # 如果设置了代理,则添加代理参数
    if PROXY:
        post_data["proxy"] = PROXY
    # 如果设置了开发者密钥,则添加
    if DEVKEY:
        post_data["devkey"] = DEVKEY
    # 如果设置了UA,则添加
    if UA:
        post_data["ua"] = UA
    print(f"[请求参数] cookie={CSDN_COOKIE[:20]}..." if len(CSDN_COOKIE) > 20 else f"[请求参数] cookie={CSDN_COOKIE}")
    print(f"[请求参数] itemid={ITEM_ID}")
    try:
        response = requests.post(url, data=post_data, timeout=60)
        result = response.json()
        if result.get("status") == 1:
            print(f"[成功] 识别成功!耗时:{result.get('time')}ms")
            print(f"[识别结果] {result.get('data')}")
        else:
            print(f"[失败] 识别失败,错误信息:{result.get('msg')}")
            print(f"[提示] 错误状态码:{result.get('status')},请参考错误代码表排查")
        print(f"\n[完整响应] {json.dumps(result, ensure_ascii=False, indent=2)}")
        return result
    except requests.exceptions.RequestException as e:
        print(f"[异常] 网络请求出错:{e}")
        return None


if __name__ == "__main__":
    print("*" * 60)
    print("  CSDN识别 Demo (Python版)")
    print("*" * 60)
    if APPKEY == "你的appkey":
        print("\n[错误] 请先在脚本顶部的配置区域填写你的 APPKEY")
        sys.exit(1)
    if CSDN_COOKIE == "你获取到的cookie":
        print("\n[错误] 请先在脚本顶部的配置区域填写 CSDN_COOKIE")
        sys.exit(1)
    recognize_csdn()
    print("\n" + "=" * 50)
    print("[完成] 识别执行完毕")
    print("=" * 50)

Go

共 2 个示例,按接口动作拆分。

该语言注意事项

跟随当前语言展示
  • ============================================================== CSDN识别 对接示例 — Go版 使用说明 ============================================================== 【一、环境准备】 1. 安装 Go - 下载地址:https://go.dev/dl/ - 建议版本:Go 1.18 或以上 - 安装完成后执行: go version 2. 无需安装第三方依赖 - 本 Demo 仅使用 Go 标准库 - 直接执行 go run 即可 -------------------------------------------------------------- 【二、参数配置】 本 Demo 包含两个独立脚本: - query_points.go — 查询账户剩余点数 - recognize_csdn.go — 提交 CSDN 验证码识别 需要重点填写: 1. APPKEY - 登录平台后在个人中心获取 2. CSDNCookie - CSDN 验证码的 waf_captcha_marker cookie 值 - 需要从浏览器开发者工具或抓包结果中获取 3. ITEMID - CSDN 固定填写 600 4. PROXY / DEVKEY / UA - 都是可选参数 - 某些场景需要补 User-Agent 时再填写 UA -------------------------------------------------------------- 【三、运行方式】 1. 进入当前目录: cd CSDN/go 2. 查询点数: go run query_points.go 3. CSDN识别: go run recognize_csdn.go -------------------------------------------------------------- 【四、常见问题】 Q1:查询点数成功但识别失败 A1:请检查 CSDNCookie 是否正确且仍然有效 Q2:返回结果无法通过目标网站验证 A2:请将返回的 data 进行 urlencode 后再提交 Q3:提示网络请求出错 A3:请检查网络、代理或 UA 是否需要同步目标站环境 -------------------------------------------------------------- 【五、重要注意事项】 1. 查询点数接口不得超过 1 秒 1 次,否则会被拉黑 24 小时 2. 识别接口超时时间为 60 秒,请耐心等待结果 3. 不要将 APPKEY 泄露给他人 4. 请确保账户点数余额充足 5. 目前 CSDN 识别支持文字点选,其他类型请联系客服 ==============================================================

查询点数

query_points.go

下载源码
query_points.go

Go

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
	"os"
	"time"
)

/*
=============================================================
  查询账户点数 Demo (Go版)

  功能说明:
  查询账户剩余点数(余额)

  使用方法:
  1. 确保已安装 Go 1.18 或更高版本
  2. 将下方的 APPKEY 替换为你自己的用户密钥
  3. 运行脚本:go run query_points.go
  4. 本 Demo 仅使用 Go 标准库,无需安装第三方依赖
=============================================================
*/

const (
	APPKEY  = "你的appkey"
	APIBase = "http://api.ttocr.com/api"
)

func queryPoints() (map[string]interface{}, error) {
	client := &http.Client{Timeout: 10 * time.Second}
	endpoint := APIBase + "/points?appkey=" + url.QueryEscape(APPKEY)

	resp, err := client.Get(endpoint)
	if err != nil {
		return nil, err
	}
	defer resp.Body.Close()

	var result map[string]interface{}
	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
		return nil, err
	}

	pretty, _ := json.MarshalIndent(result, "", "  ")
	if status, ok := result["status"].(float64); ok && status == 1 {
		fmt.Printf("[成功] 查询成功!当前可用点数:%v\n", result["points"])
	} else {
		fmt.Printf("[失败] 查询失败,错误信息:%v\n", result["msg"])
		fmt.Printf("[提示] 错误状态码:%v,请参考错误代码表排查\n", result["status"])
	}
	fmt.Printf("[完整响应] %s\n", string(pretty))

	return result, nil
}

func main() {
	fmt.Println("************************************************************")
	fmt.Println("  查询账户点数 Demo (Go版)")
	fmt.Println("************************************************************")

	if APPKEY == "你的appkey" {
		fmt.Println("\n[错误] 请先在代码顶部的配置区域填写你的 APPKEY")
		os.Exit(1)
	}

	fmt.Println("==================================================")
	fmt.Println("[查询点数] 正在查询账户剩余点数...")
	fmt.Println("==================================================")

	if _, err := queryPoints(); err != nil {
		fmt.Printf("[异常] 网络请求出错:%v\n", err)
		os.Exit(1)
	}

	fmt.Println("\n==================================================")
	fmt.Println("[完成] 查询执行完毕")
	fmt.Println("==================================================")
}

提交识别

recognize_csdn.go

下载源码
recognize_csdn.go

Go

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
	"os"
	"time"
)

/*
=============================================================
  CSDN识别 Demo (Go版)

  功能说明:
  提交CSDN验证码识别任务(目前支持文字点选)

  使用方法:
  1. 确保已安装 Go 1.18 或更高版本
  2. 将下方的 APPKEY 替换为你自己的用户密钥
  3. 将 CSDN_COOKIE 替换为你获取到的 waf_captcha_marker cookie 值
  4. 运行脚本:go run recognize_csdn.go
=============================================================
*/

const (
	APPKEY       = "你的appkey"
	CSDNCookie   = "你获取到的cookie"
	ITEMID       = "600"
	PROXY        = ""
	DEVKEY       = ""
	UA           = ""
	APIBase      = "http://api.ttocr.com/api"
	RequestDelay = 60 * time.Second
)

func postForm(endpoint string, values url.Values, timeout time.Duration) (map[string]interface{}, error) {
	client := &http.Client{Timeout: timeout}
	resp, err := client.PostForm(endpoint, values)
	if err != nil {
		return nil, err
	}
	defer resp.Body.Close()

	var result map[string]interface{}
	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
		return nil, err
	}

	return result, nil
}

func main() {
	fmt.Println("************************************************************")
	fmt.Println("  CSDN识别 Demo (Go版)")
	fmt.Println("************************************************************")

	if APPKEY == "你的appkey" {
		fmt.Println("\n[错误] 请先在代码顶部的配置区域填写你的 APPKEY")
		os.Exit(1)
	}
	if CSDNCookie == "你获取到的cookie" {
		fmt.Println("\n[错误] 请先在代码顶部的配置区域填写 CSDN_COOKIE")
		os.Exit(1)
	}

	fmt.Println("==================================================")
	fmt.Println("[CSDN识别] 正在提交CSDN识别任务...")
	fmt.Println("==================================================")

	values := url.Values{}
	values.Set("appkey", APPKEY)
	values.Set("cookie", CSDNCookie)
	values.Set("itemid", ITEMID)
	if PROXY != "" {
		values.Set("proxy", PROXY)
	}
	if DEVKEY != "" {
		values.Set("devkey", DEVKEY)
	}
	if UA != "" {
		values.Set("ua", UA)
	}

	displayCookie := CSDNCookie
	if len(displayCookie) > 20 {
		displayCookie = displayCookie[:20] + "..."
	}
	fmt.Printf("[请求参数] cookie=%s\n", displayCookie)
	fmt.Printf("[请求参数] itemid=%s\n", ITEMID)

	result, err := postForm(APIBase+"/recognize2", values, RequestDelay)
	if err != nil {
		fmt.Printf("[异常] 网络请求出错:%v\n", err)
		os.Exit(1)
	}

	pretty, _ := json.MarshalIndent(result, "", "  ")
	if status, ok := result["status"].(float64); ok && status == 1 {
		fmt.Printf("[成功] 识别成功!耗时:%vms\n", result["time"])
		fmt.Printf("[识别结果] %v\n", result["data"])
	} else {
		fmt.Printf("[失败] 识别失败,错误信息:%v\n", result["msg"])
		fmt.Printf("[提示] 错误状态码:%v,请参考错误代码表排查\n", result["status"])
		fmt.Println("[提示] 如果结果无法通过验证,请将返回的 data 进行 urlencode 后再提交。")
	}
	fmt.Printf("\n[完整响应] %s\n", string(pretty))

	fmt.Println("\n==================================================")
	fmt.Println("[完成] 识别执行完毕")
	fmt.Println("==================================================")
}

易语言

共 2 个示例,按接口动作拆分。

该语言注意事项

跟随当前语言展示
  • ============================================================== CSDN识别 对接示例 — 易语言版 使用说明 ============================================================== 【一、依赖说明】 1. 需要导入:精易模块 2. 本示例实际用到的命令 / 类: - 网页_访问_对象 - 类_POST数据类 - 类_json - 编码_URL编码 - 编码_Utf8到Ansi 3. 本次没有额外依赖 `spec` -------------------------------------------------------------- 【二、这次源码的结构说明】 1. `功能_查询点数 / 功能_CSDN识别` 是示例里自己写的子程序 2. 命名风格参考了精易论坛里常见的“网页调试助手生成”格式 3. 它们不是内置命令 -------------------------------------------------------------- 【三、参数怎么填】 1. `APPKEY` - 你自己的平台密钥 2. `CSDNCookie` - 浏览器里 `waf_captcha_marker` 的值 3. `ITEMID` - CSDN 固定 `600` 4. `PROXY / DEVKEY / UA` - 都是可选参数 -------------------------------------------------------------- 【四、输出结果怎么看】 1. 示例默认用 `输出调试文本` 看接口返回 2. 适合直接在 IDE 调试时观察 3. 如果你要放到正式窗口里: - 建议把返回值写到编辑框 - 或写到日志文件 -------------------------------------------------------------- 【五、调用注意事项】 1. 查询点数接口不得超过 1 秒 1 次,否则会被拉黑 24 小时 2. CSDN 当前固定走 `/api/recognize2` 3. `itemid` 固定 `600` 4. 如果返回结果提交后无法通过,请先对 `data` 再做一次 urlencode 5. 如果站点校验 UA,请把抓包里的 User-Agent 填到 `UA` ==============================================================

查询点数

QueryPoints.e

下载源码
QueryPoints.e

易语言

.版本 2

.子程序 _启动子程序, 整数型, , 本子程序在程序启动后最先执行
.局部变量 APPKEY, 文本型
.局部变量 返回文本, 文本型
.局部变量 json, 类_json

APPKEY = "你的appkey"

.如果真 (APPKEY = "你的appkey")
    输出调试文本 ("[错误] 请先把 APPKEY 改成你自己的密钥")
    返回 (0)
.如果真结束

返回文本 = 功能_查询点数 (APPKEY)
输出调试文本 ("[完整响应]" + #换行符 + 返回文本)

.如果真 (json.解析 (返回文本, , ))
    .如果真 (json.取通用属性 ("status", ) = "1")
        输出调试文本 ("[成功] 当前可用点数:" + 到文本 (json.取通用属性 ("points", )))
    .否则
        输出调试文本 ("[失败] " + 到文本 (json.取通用属性 ("msg", )))
    .如果真结束
.否则
    输出调试文本 ("[失败] JSON 解析失败,请检查返回内容")
.如果真结束

返回 (0)

.子程序 功能_查询点数, 文本型, , 本命令由〖精易网页调试助手〗生成,请配合精易模块使用。
.参数 APPKEY, 文本型
.局部变量 局_网址, 文本型
.局部变量 局_方式, 整数型
.局部变量 ADD_协议头, 类_POST数据类
.局部变量 局_提交协议头, 文本型
.局部变量 局_结果, 字节集
.局部变量 局_返回, 文本型

局_网址 = "http://api.ttocr.com/api/points?appkey=" + 编码_URL编码 (APPKEY, 真, 真)
局_方式 = 0
ADD_协议头.添加 ("Accept", "application/json", )
ADD_协议头.添加 ("User-Agent", "Mozilla/5.0", )
局_提交协议头 = ADD_协议头.获取协议头数据 ()
局_结果 = 网页_访问_对象 (局_网址, 局_方式, , , , 局_提交协议头, , , , , , , , , , , )
局_返回 = 到文本 (编码_Utf8到Ansi (局_结果))
返回 (局_返回)

提交识别

RecognizeCsdn.e

下载源码
RecognizeCsdn.e

易语言

.版本 2

.子程序 _启动子程序, 整数型, , 本子程序在程序启动后最先执行
.局部变量 APPKEY, 文本型
.局部变量 CSDNCookie, 文本型
.局部变量 ITEMID, 文本型
.局部变量 PROXY, 文本型
.局部变量 DEVKEY, 文本型
.局部变量 UA, 文本型
.局部变量 返回文本, 文本型
.局部变量 json, 类_json

APPKEY = "你的appkey"
CSDNCookie = "你获取到的cookie"
ITEMID = "600"
PROXY = ""
DEVKEY = ""
UA = ""

.如果真 (APPKEY = "你的appkey")
    输出调试文本 ("[错误] 请先把 APPKEY 改成你自己的密钥")
    返回 (0)
.如果真结束

.如果真 (CSDNCookie = "你获取到的cookie")
    输出调试文本 ("[错误] 请先填写 waf_captcha_marker 对应的 Cookie 值")
    返回 (0)
.如果真结束

返回文本 = 功能_CSDN识别 (APPKEY, CSDNCookie, ITEMID, PROXY, DEVKEY, UA)
输出调试文本 ("[完整响应]" + #换行符 + 返回文本)

.如果真 (json.解析 (返回文本, , ))
    .如果真 (json.取通用属性 ("status", ) = "1")
        输出调试文本 ("[成功] 耗时:" + 到文本 (json.取通用属性 ("time", )) + "ms")
        输出调试文本 ("[识别结果] " + 到文本 (json.取通用属性 ("data", )))
    .否则
        输出调试文本 ("[失败] " + 到文本 (json.取通用属性 ("msg", )))
        输出调试文本 ("[提示] 如果结果提交后无法通过,请先对 data 再做一次 urlencode")
    .如果真结束
.否则
    输出调试文本 ("[失败] JSON 解析失败,请检查返回内容")
.如果真结束

返回 (0)

.子程序 功能_CSDN识别, 文本型, , 本命令由〖精易网页调试助手〗生成,请配合精易模块使用。
.参数 APPKEY, 文本型
.参数 CSDNCookie, 文本型
.参数 ITEMID, 文本型
.参数 PROXY, 文本型
.参数 DEVKEY, 文本型
.参数 UA, 文本型
.局部变量 局_网址, 文本型
.局部变量 局_方式, 整数型
.局部变量 局_提交数据, 文本型
.局部变量 ADD_协议头, 类_POST数据类
.局部变量 局_提交协议头, 文本型
.局部变量 局_结果, 字节集
.局部变量 局_返回, 文本型

局_网址 = "http://api.ttocr.com/api/recognize2"
局_方式 = 1
局_提交数据 = "appkey=" + 编码_URL编码 (APPKEY, 真, 真)
局_提交数据 = 局_提交数据 + "&cookie=" + 编码_URL编码 (CSDNCookie, 真, 真)
局_提交数据 = 局_提交数据 + "&itemid=" + 编码_URL编码 (ITEMID, 真, 真)

.如果真 (PROXY = "")
.否则
    局_提交数据 = 局_提交数据 + "&proxy=" + 编码_URL编码 (PROXY, 真, 真)
.如果真结束

.如果真 (DEVKEY = "")
.否则
    局_提交数据 = 局_提交数据 + "&devkey=" + 编码_URL编码 (DEVKEY, 真, 真)
.如果真结束

.如果真 (UA = "")
.否则
    局_提交数据 = 局_提交数据 + "&ua=" + 编码_URL编码 (UA, 真, 真)
.如果真结束

ADD_协议头.添加 ("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8", )
ADD_协议头.添加 ("Accept", "application/json", )
ADD_协议头.添加 ("User-Agent", "Mozilla/5.0", )
局_提交协议头 = ADD_协议头.获取协议头数据 ()
局_结果 = 网页_访问_对象 (局_网址, 局_方式, 局_提交数据, , , 局_提交协议头, , , , , , , , , , , )
局_返回 = 到文本 (编码_Utf8到Ansi (局_结果))
返回 (局_返回)

Node.js

共 2 个示例,按接口动作拆分。

该语言注意事项

跟随当前语言展示
  • ============================================================== CSDN识别 对接示例 — Node.js版 使用说明 ============================================================== 【一、环境准备】 1. 安装 Node.js - 下载地址:https://nodejs.org/ - 建议版本:v12.0.0 或以上(推荐LTS长期支持版) - 安装时保持默认设置即可 - 安装完成后,打开命令行(cmd 或 PowerShell),输入以下命令验证: node --version 如果显示类似 "v18.x.x" 则安装成功 2. 无需安装第三方依赖 - 本Demo仅使用Node.js内置模块(http、querystring) - 无需执行 npm install -------------------------------------------------------------- 【二、参数配置】 本Demo包含两个独立脚本: - query_points.js — 查询账户剩余点数 - recognize_csdn.js — 提交CSDN验证码识别 请根据需要打开对应的脚本文件,找到顶部的"配置区域",修改以下参数: 1. APPKEY(必填) - 你的用户密钥,登录平台后在个人中心获取 - 示例:const APPKEY = "abc123def456"; 2. CSDN_COOKIE(必填) - CSDN验证码的 waf_captcha_marker cookie字段值 - 需要从浏览器开发者工具(F12)中获取 - 打开浏览器 → F12 → Application/应用 → Cookies → 找到 waf_captcha_marker 字段 - 示例:const CSDN_COOKIE = "39f8d06301c63ecc990e..."; 3. ITEM_ID(一般不需要改) - CSDN类型固定填写 600 4. PROXY(可选) - 代理IP地址,支持的格式: * http://IP:端口 (普通HTTP代理,若需白名单支持请联系客服) * http://账号:密码@proxy.com:8080 (带认证的HTTP代理) * socks5://127.0.0.1:9888 (SOCKS5代理) 5. DEVKEY(可选) - 开发者密钥 6. UA(可选) - User-Agent值 -------------------------------------------------------------- 【三、运行方式】 1. 打开命令行(cmd 或 PowerShell) 2. 切换到脚本所在目录: cd CSDN\nodejs 查询点数: 3. 执行:node query_points.js CSDN识别: 4. 执行:node recognize_csdn.js 5. 识别结果会在控制台中显示 -------------------------------------------------------------- 【四、常见问题】 Q1:运行时提示 "node 不是内部或外部命令" A1:Node.js未安装或未添加到系统PATH,请参考【一、环境准备】 Q2:查询点数成功但识别失败 A2:请检查 CSDN_COOKIE 是否正确,cookie值需要实时获取 Q3:返回的结果无法通过验证 A3:尝试对返回的 data 值进行 encodeURIComponent() 编码后再使用 Q4:提示连接超时 A4:识别任务需要服务器处理,超时时间已设置为120秒,请耐心等待 -------------------------------------------------------------- 【五、重要注意事项】 1. 查询点数接口有频率限制:不得超过1秒1次,否则会被拉黑24小时 2. 本Demo使用Node.js内置模块,无需npm安装任何依赖 3. 不要将你的 APPKEY 泄露给他人 4. 请确保你的账户有足够的点数余额 5. 目前CSDN识别支持文字点选,若需其他类型请联系客服 6. 如果提交结果失败无法通过,请将结果URL编码后提交 ==============================================================

查询点数

query_points.js

下载源码
query_points.js

Node.js

/**
 * =============================================================
 *   查询账户点数 Demo (Node.js版)
 *
 *   功能说明:
 *   查询账户剩余点数(余额)
 *
 *   使用方法:
 *   1. 确保已安装 Node.js (建议 v12+)
 *   2. 将下方的 APPKEY 替换为你自己的用户密钥
 *   3. 运行脚本:node query_points.js
 *   注意:本Demo使用Node.js内置模块,无需安装第三方依赖
 * =============================================================
 */

const http = require('http');

// ======================== 配置区域(请替换为你自己的参数)========================
// 用户密钥,登录平台后获取
const APPKEY = "你的appkey";
// ===============================================================================

// API基础地址
const API_BASE = "http://api.ttocr.com/api";

/**
 * 发送HTTP GET请求
 */
function httpGet(url) {
    return new Promise((resolve, reject) => {
        http.get(url, { timeout: 10000 }, (res) => {
            let data = '';
            res.on('data', (chunk) => { data += chunk; });
            res.on('end', () => {
                try { resolve(JSON.parse(data)); }
                catch (e) { reject(new Error('JSON解析失败: ' + data)); }
            });
        }).on('error', reject);
    });
}

/**
 * 查询账户剩余点数
 * 接口地址:GET http://api.ttocr.com/api/points
 * 注意:查询点数不得超过1秒1次,否则会被拉黑24小时
 */
async function queryPoints() {
    console.log("=".repeat(50));
    console.log("[查询点数] 正在查询账户剩余点数...");
    console.log("=".repeat(50));
    try {
        const url = `${API_BASE}/points?appkey=${encodeURIComponent(APPKEY)}`;
        const result = await httpGet(url);
        if (result.status === 1) {
            console.log(`[成功] 查询成功!当前可用点数:${result.points}`);
        } else {
            console.log(`[失败] 查询失败,错误信息:${result.msg}`);
            console.log(`[提示] 错误状态码:${result.status},请参考错误代码表排查`);
        }
        console.log(`[完整响应] ${JSON.stringify(result, null, 2)}`);
        return result;
    } catch (e) {
        console.log(`[异常] 网络请求出错:${e.message}`);
        return null;
    }
}

// 主流程
async function main() {
    console.log("*".repeat(60));
    console.log("  查询账户点数 Demo (Node.js版)");
    console.log("*".repeat(60));

    if (APPKEY === "你的appkey") {
        console.log("\n[错误] 请先在脚本顶部的配置区域填写你的 APPKEY");
        process.exit(1);
    }

    await queryPoints();

    console.log("\n" + "=".repeat(50));
    console.log("[完成] 查询执行完毕");
    console.log("=".repeat(50));
}

main().catch(err => {
    console.error("[致命错误]", err.message);
    process.exit(1);
});

提交识别

recognize_csdn.js

下载源码
recognize_csdn.js

Node.js

/**
 * =============================================================
 *   CSDN识别 Demo (Node.js版)
 *
 *   功能说明:
 *   提交CSDN验证码识别任务(目前支持文字点选)
 *
 *   使用方法:
 *   1. 确保已安装 Node.js (建议 v12+)
 *   2. 将下方的 APPKEY 替换为你自己的用户密钥
 *   3. 将 CSDN_COOKIE 替换为你获取到的 waf_captcha_marker cookie值
 *   4. 运行脚本:node recognize_csdn.js
 *   注意:本Demo使用Node.js内置模块,无需安装第三方依赖
 * =============================================================
 */

const http = require('http');
const querystring = require('querystring');

// ======================== 配置区域(请替换为你自己的参数)========================
// 用户密钥,登录平台后获取
const APPKEY = "你的appkey";

// CSDN验证码的 waf_captcha_marker cookie字段值(从浏览器抓包获取)
const CSDN_COOKIE = "你获取到的cookie";

// 项目类型,CSDN固定填写 600(特殊类型请联系客服)
const ITEM_ID = 600;

// 可选参数:代理IP(格式示例:http://IP:端口,若需白名单支持请联系客服。http://账号:密码@proxy.com:8080 或 socks5://127.0.0.1:9888)
const PROXY = "";

// 可选参数:开发者密钥(如果有的话填写)
const DEVKEY = "";

// 可选参数:User-Agent(如果需要的话填写)
const UA = "";
// ===============================================================================

// API基础地址
const API_BASE = "http://api.ttocr.com/api";

/**
 * 发送HTTP POST请求(表单数据)
 */
function httpPost(url, postData) {
    return new Promise((resolve, reject) => {
        const data = querystring.stringify(postData);
        const urlObj = new URL(url);
        const options = {
            hostname: urlObj.hostname,
            port: urlObj.port || 80,
            path: urlObj.pathname,
            method: 'POST',
            timeout: 120000, // 识别可能需要较长时间
            headers: {
                'Content-Type': 'application/x-www-form-urlencoded',
                'Content-Length': Buffer.byteLength(data)
            }
        };
        const req = http.request(options, (res) => {
            let body = '';
            res.on('data', (chunk) => { body += chunk; });
            res.on('end', () => {
                try { resolve(JSON.parse(body)); }
                catch (e) { reject(new Error('JSON解析失败: ' + body)); }
            });
        });
        req.on('error', reject);
        req.write(data);
        req.end();
    });
}

/**
 * 提交CSDN验证码识别任务
 * 接口地址:POST http://api.ttocr.com/api/recognize2
 * 必填参数:appkey, cookie, itemid(固定600)
 * 可选参数:proxy, devkey, ua
 * 重要提示:如果提交结果失败无法通过,请将结果URL编码后提交
 */
async function recognizeCsdn() {
    console.log("=".repeat(50));
    console.log("[CSDN识别] 正在提交CSDN识别任务...");
    console.log("=".repeat(50));
    const postData = {
        appkey: APPKEY,
        cookie: CSDN_COOKIE,
        itemid: ITEM_ID,
    };
    if (PROXY) { postData.proxy = PROXY; }
    if (DEVKEY) { postData.devkey = DEVKEY; }
    if (UA) { postData.ua = UA; }
    console.log(`[请求参数] cookie=${CSDN_COOKIE.length > 20 ? CSDN_COOKIE.substring(0, 20) + '...' : CSDN_COOKIE}`);
    console.log(`[请求参数] itemid=${ITEM_ID}`);
    try {
        const url = `${API_BASE}/recognize2`;
        const result = await httpPost(url, postData);
        if (result.status === 1) {
            console.log(`[成功] 识别成功!耗时:${result.time}ms`);
            console.log(`[识别结果] ${result.data}`);
        } else {
            console.log(`[失败] 识别失败,错误信息:${result.msg}`);
            console.log(`[提示] 错误状态码:${result.status},请参考错误代码表排查`);
        }
        console.log(`\n[完整响应] ${JSON.stringify(result, null, 2)}`);
        return result;
    } catch (e) {
        console.log(`[异常] 网络请求出错:${e.message}`);
        return null;
    }
}

// 主流程
async function main() {
    console.log("*".repeat(60));
    console.log("  CSDN识别 Demo (Node.js版)");
    console.log("*".repeat(60));

    if (APPKEY === "你的appkey") {
        console.log("\n[错误] 请先在脚本顶部的配置区域填写你的 APPKEY");
        process.exit(1);
    }
    if (CSDN_COOKIE === "你获取到的cookie") {
        console.log("\n[错误] 请先在脚本顶部的配置区域填写 CSDN_COOKIE");
        process.exit(1);
    }

    await recognizeCsdn();

    console.log("\n" + "=".repeat(50));
    console.log("[完成] 识别执行完毕");
    console.log("=".repeat(50));
}

main().catch(err => {
    console.error("[致命错误]", err.message);
    process.exit(1);
});

Java

共 2 个示例,按接口动作拆分。

该语言注意事项

跟随当前语言展示
  • ============================================================== CSDN识别 对接示例 — Java版 使用说明 ============================================================== 【一、环境准备】 1. 安装 JDK(Java Development Kit) - 下载地址:https://www.oracle.com/java/technologies/downloads/ - 或者使用OpenJDK:https://adoptium.net/ - 建议版本:JDK 8 或以上 - 安装完成后,打开命令行(cmd 或 PowerShell),输入以下命令验证: java -version javac -version 如果显示版本号则安装成功 2. 配置环境变量(如果上一步验证失败) - 设置 JAVA_HOME 为JDK安装目录 - 将 %JAVA_HOME%\bin 添加到系统 PATH 中 -------------------------------------------------------------- 【二、参数配置】 本Demo包含两个独立源文件: - QueryPoints.java — 查询账户剩余点数 - RecognizeCsdn.java — 提交CSDN验证码识别 请根据需要打开对应的源文件,找到顶部的"配置区域",修改以下参数: 1. APPKEY(必填) - 你的用户密钥,登录平台后在个人中心获取 - 示例:private static final String APPKEY = "abc123def456"; 2. CSDN_COOKIE(必填) - CSDN验证码的 waf_captcha_marker cookie字段值 - 需要从浏览器开发者工具(F12)中获取 - 打开浏览器 → F12 → Application/应用 → Cookies → 找到 waf_captcha_marker 字段 - 示例:private static final String CSDN_COOKIE = "39f8d06301c63ecc990e..."; 3. ITEM_ID(一般不需要改) - CSDN类型固定填写 600 4. PROXY(可选) - 代理IP地址,支持的格式: * http://IP:端口 (普通HTTP代理,若需白名单支持请联系客服) * http://账号:密码@proxy.com:8080 (带认证的HTTP代理) * socks5://127.0.0.1:9888 (SOCKS5代理) 5. DEVKEY(可选) - 开发者密钥 6. UA(可选) - User-Agent值 -------------------------------------------------------------- 【三、编译与运行】 1. 打开命令行(cmd 或 PowerShell) 2. 切换到源文件所在目录: cd CSDN\java 查询点数: 3. 编译:javac -encoding UTF-8 QueryPoints.java 4. 运行:java QueryPoints CSDN识别: 5. 编译:javac -encoding UTF-8 RecognizeCsdn.java 6. 运行:java RecognizeCsdn 注意:编译时必须加 -encoding UTF-8 参数,否则中文注释可能导致编译错误 -------------------------------------------------------------- 【四、常见问题】 Q1:编译时提示 "javac 不是内部或外部命令" A1:JDK未安装或环境变量未配置,请参考【一、环境准备】 Q2:编译时中文乱码或报错 A2:请确保使用 -encoding UTF-8 参数编译 Q3:查询点数成功但识别失败 A3:请检查 CSDN_COOKIE 是否正确,cookie值需要实时获取 Q4:返回的结果无法通过验证 A4:尝试对返回的 data 值进行 URLEncoder.encode() 编码后再使用 Q5:识别耗时较长 A5:这是正常现象,超时时间已设置为120秒 -------------------------------------------------------------- 【五、重要注意事项】 1. 查询点数接口有频率限制:不得超过1秒1次,否则会被拉黑24小时 2. 本Demo使用纯JDK内置类,无需引入第三方库 3. 不要将你的 APPKEY 泄露给他人 4. 请确保你的账户有足够的点数余额 5. 目前CSDN识别支持文字点选,若需其他类型请联系客服 6. 如果提交结果失败无法通过,请将结果URL编码后提交 ==============================================================

查询点数

QueryPoints.java

下载源码
QueryPoints.java

Java

import java.io.*;
import java.net.*;
import java.nio.charset.StandardCharsets;

/**
 * =============================================================
 *   查询账户点数 Demo (Java版)
 *
 *   功能说明:
 *   查询账户剩余点数(余额)
 *
 *   使用方法:
 *   1. 将下方的 APPKEY 替换为你自己的用户密钥
 *   2. 编译运行:javac -encoding UTF-8 QueryPoints.java && java QueryPoints
 * =============================================================
 */
public class QueryPoints {

    // ======================== 配置区域(请替换为你自己的参数)========================
    // 用户密钥,登录平台后获取
    private static final String APPKEY = "你的appkey";
    // ===============================================================================

    // API基础地址
    private static final String API_BASE = "http://api.ttocr.com/api";

    /**
     * 发送GET请求
     */
    private static String httpGet(String urlStr) throws Exception {
        URL url = new URL(urlStr);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET");
        conn.setConnectTimeout(10000);
        conn.setReadTimeout(10000);
        BufferedReader reader = new BufferedReader(
                new InputStreamReader(conn.getInputStream(), StandardCharsets.UTF_8));
        StringBuilder sb = new StringBuilder();
        String line;
        while ((line = reader.readLine()) != null) {
            sb.append(line);
        }
        reader.close();
        conn.disconnect();
        return sb.toString();
    }

    /**
     * 查询账户剩余点数
     * 接口地址:GET http://api.ttocr.com/api/points
     * 注意:查询点数不得超过1秒1次,否则会被拉黑24小时
     */
    public static void main(String[] args) {
        System.out.println("************************************************************");
        System.out.println("  查询账户点数 Demo (Java版)");
        System.out.println("************************************************************");

        // 检查参数是否已配置
        if ("你的appkey".equals(APPKEY)) {
            System.out.println("\n[错误] 请先在代码顶部的配置区域填写你的 APPKEY");
            System.exit(1);
        }

        System.out.println("==================================================");
        System.out.println("[查询点数] 正在查询账户剩余点数...");
        System.out.println("==================================================");
        try {
            String url = API_BASE + "/points?appkey=" + URLEncoder.encode(APPKEY, "UTF-8");
            String result = httpGet(url);
            System.out.println("[完整响应] " + result);
        } catch (Exception e) {
            System.out.println("[异常] 网络请求出错:" + e.getMessage());
        }

        System.out.println("\n==================================================");
        System.out.println("[完成] 查询执行完毕");
        System.out.println("==================================================");
    }
}

提交识别

RecognizeCsdn.java

下载源码
RecognizeCsdn.java

Java

import java.io.*;
import java.net.*;
import java.nio.charset.StandardCharsets;

/**
 * =============================================================
 *   CSDN识别 Demo (Java版)
 *
 *   功能说明:
 *   提交CSDN验证码识别任务(目前支持文字点选)
 *
 *   使用方法:
 *   1. 将下方的 APPKEY 替换为你自己的用户密钥
 *   2. 将 CSDN_COOKIE 替换为你获取到的 waf_captcha_marker cookie值
 *   3. 编译运行:javac -encoding UTF-8 RecognizeCsdn.java && java RecognizeCsdn
 * =============================================================
 */
public class RecognizeCsdn {

    // ======================== 配置区域(请替换为你自己的参数)========================
    // 用户密钥,登录平台后获取
    private static final String APPKEY = "你的appkey";

    // CSDN验证码的 waf_captcha_marker cookie字段值(从浏览器抓包获取)
    private static final String CSDN_COOKIE = "你获取到的cookie";

    // 项目类型,CSDN固定填写 600(特殊类型请联系客服)
    private static final int ITEM_ID = 600;

    // 可选参数:代理IP(格式示例:http://IP:端口,若需白名单支持请联系客服。http://账号:密码@proxy.com:8080 或 socks5://127.0.0.1:9888)
    private static final String PROXY = "";

    // 可选参数:开发者密钥(如果有的话填写)
    private static final String DEVKEY = "";

    // 可选参数:User-Agent(如果需要的话填写)
    private static final String UA = "";
    // ===============================================================================

    // API基础地址
    private static final String API_BASE = "http://api.ttocr.com/api";

    /**
     * 发送POST请求(表单数据)
     */
    private static String httpPost(String urlStr, String postData) throws Exception {
        URL url = new URL(urlStr);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("POST");
        conn.setDoOutput(true);
        conn.setConnectTimeout(10000);
        conn.setReadTimeout(120000); // 识别可能需要较长时间
        conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
        OutputStream os = conn.getOutputStream();
        os.write(postData.getBytes(StandardCharsets.UTF_8));
        os.flush();
        os.close();
        BufferedReader reader = new BufferedReader(
                new InputStreamReader(conn.getInputStream(), StandardCharsets.UTF_8));
        StringBuilder sb = new StringBuilder();
        String line;
        while ((line = reader.readLine()) != null) {
            sb.append(line);
        }
        reader.close();
        conn.disconnect();
        return sb.toString();
    }

    /**
     * 提交CSDN验证码识别任务
     * 接口地址:POST http://api.ttocr.com/api/recognize2
     * 必填参数:appkey, cookie, itemid(固定600)
     * 可选参数:proxy, devkey, ua
     * 重要提示:如果提交结果失败无法通过,请将结果URL编码后提交
     */
    public static void main(String[] args) {
        System.out.println("************************************************************");
        System.out.println("  CSDN识别 Demo (Java版)");
        System.out.println("************************************************************");

        // 检查参数是否已配置
        if ("你的appkey".equals(APPKEY)) {
            System.out.println("\n[错误] 请先在代码顶部的配置区域填写你的 APPKEY");
            System.exit(1);
        }
        if ("你获取到的cookie".equals(CSDN_COOKIE)) {
            System.out.println("\n[错误] 请先在代码顶部的配置区域填写 CSDN_COOKIE");
            System.exit(1);
        }

        System.out.println("==================================================");
        System.out.println("[CSDN识别] 正在提交CSDN识别任务...");
        System.out.println("==================================================");
        try {
            String url = API_BASE + "/recognize2";
            // 构建POST请求数据
            StringBuilder postData = new StringBuilder();
            postData.append("appkey=").append(URLEncoder.encode(APPKEY, "UTF-8"));
            postData.append("&cookie=").append(URLEncoder.encode(CSDN_COOKIE, "UTF-8"));
            postData.append("&itemid=").append(ITEM_ID);
            // 如果设置了代理,则添加代理参数
            if (PROXY != null && !PROXY.isEmpty()) {
                postData.append("&proxy=").append(URLEncoder.encode(PROXY, "UTF-8"));
            }
            // 如果设置了开发者密钥,则添加
            if (DEVKEY != null && !DEVKEY.isEmpty()) {
                postData.append("&devkey=").append(URLEncoder.encode(DEVKEY, "UTF-8"));
            }
            // 如果设置了UA,则添加
            if (UA != null && !UA.isEmpty()) {
                postData.append("&ua=").append(URLEncoder.encode(UA, "UTF-8"));
            }
            System.out.println("[请求参数] cookie=" + CSDN_COOKIE.substring(0, Math.min(20, CSDN_COOKIE.length())) + "...");
            System.out.println("[请求参数] itemid=" + ITEM_ID);
            String result = httpPost(url, postData.toString());
            System.out.println("[完整响应] " + result);
        } catch (Exception e) {
            System.out.println("[异常] 网络请求出错:" + e.getMessage());
        }

        System.out.println("\n==================================================");
        System.out.println("[完成] 识别执行完毕");
        System.out.println("==================================================");
    }
}

Rust

共 2 个示例,按接口动作拆分。

该语言注意事项

跟随当前语言展示
  • ============================================================== CSDN识别 对接示例 — Rust版 使用说明 ============================================================== 【一、环境准备】 1. 安装 Rust / Cargo - 官方地址:https://www.rust-lang.org/tools/install - 安装完成后执行: rustc --version cargo --version 2. 安装依赖 - 进入你的 Cargo 项目后执行: cargo add reqwest --features blocking,json,rustls-tls cargo add serde_json -------------------------------------------------------------- 【二、参数配置】 本 Demo 包含两个独立脚本: - query_points.rs — 查询账户剩余点数 - recognize_csdn.rs — 提交 CSDN 验证码识别 需要重点填写: 1. APPKEY 2. CSDN_COOKIE 3. ITEM_ID 固定为 600 4. PROXY / DEVKEY / UA 视情况选填 -------------------------------------------------------------- 【三、运行方式】 1. 将文件放入 Cargo 项目中,例如: src/bin/query_points.rs src/bin/recognize_csdn.rs 2. 查询点数: cargo run --bin query_points 3. CSDN识别: cargo run --bin recognize_csdn -------------------------------------------------------------- 【四、常见问题】 Q1:编译时报缺少 reqwest 或 serde_json A1:请先执行 cargo add 安装依赖 Q2:返回结果无法通过目标网站验证 A2:请将返回的 data 进行 urlencode 后再提交 Q3:提示网络请求出错 A3:请检查网络、代理或 UA 是否需要同步目标站环境 -------------------------------------------------------------- 【五、重要注意事项】 1. 查询点数接口不得超过 1 秒 1 次,否则会被拉黑 24 小时 2. 识别接口超时时间为 60 秒,请耐心等待结果 3. 不要将 APPKEY 泄露给他人 4. 请确保账户点数余额充足 5. 目前 CSDN 识别支持文字点选,其他类型请联系客服 ==============================================================

查询点数

query_points.rs

下载源码
query_points.rs

Rust

/*
=============================================================
  查询账户点数 Demo (Rust版)

  功能说明:
  查询账户剩余点数(余额)

  使用方法:
  1. 确保已安装 Rust / Cargo(建议 stable 版本)
  2. 执行:
       cargo add reqwest --features blocking,json,rustls-tls
       cargo add serde_json
  3. 将下方的 APPKEY 替换为你自己的用户密钥
  4. 运行脚本:cargo run --bin query_points
=============================================================
*/

use reqwest::blocking::Client;
use serde_json::Value;
use std::error::Error;
use std::process;
use std::time::Duration;

const APPKEY: &str = "你的appkey";
const API_BASE: &str = "http://api.ttocr.com/api";

fn query_points() -> Result<Value, Box<dyn Error>> {
    let client = Client::builder().timeout(Duration::from_secs(10)).build()?;
    let result: Value = client
        .get(&format!("{}/points", API_BASE))
        .query(&[("appkey", APPKEY)])
        .send()?
        .json()?;

    if result["status"].as_i64() == Some(1) {
        println!("[成功] 查询成功!当前可用点数:{}", result["points"]);
    } else {
        println!("[失败] 查询失败,错误信息:{}", result["msg"]);
        println!("[提示] 错误状态码:{},请参考错误代码表排查", result["status"]);
    }

    println!(
        "[完整响应] {}",
        serde_json::to_string_pretty(&result).unwrap_or_else(|_| result.to_string())
    );

    Ok(result)
}

fn main() {
    println!("************************************************************");
    println!("  查询账户点数 Demo (Rust版)");
    println!("************************************************************");

    if APPKEY == "你的appkey" {
        println!("\n[错误] 请先在代码顶部的配置区域填写你的 APPKEY");
        process::exit(1);
    }

    println!("==================================================");
    println!("[查询点数] 正在查询账户剩余点数...");
    println!("==================================================");

    if let Err(error) = query_points() {
        println!("[异常] 网络请求出错:{}", error);
        process::exit(1);
    }

    println!("\n==================================================");
    println!("[完成] 查询执行完毕");
    println!("==================================================");
}

提交识别

recognize_csdn.rs

下载源码
recognize_csdn.rs

Rust

/*
=============================================================
  CSDN识别 Demo (Rust版)

  功能说明:
  提交CSDN验证码识别任务(目前支持文字点选)

  使用方法:
  1. 确保已安装 Rust / Cargo(建议 stable 版本)
  2. 执行:
       cargo add reqwest --features blocking,json,rustls-tls
       cargo add serde_json
  3. 将下方的 APPKEY / CSDN_COOKIE 替换为你自己的值
  4. 运行脚本:cargo run --bin recognize_csdn
=============================================================
*/

use reqwest::blocking::Client;
use serde_json::Value;
use std::collections::HashMap;
use std::error::Error;
use std::process;
use std::time::Duration;

const APPKEY: &str = "你的appkey";
const CSDN_COOKIE: &str = "你获取到的cookie";
const ITEM_ID: &str = "600";
const PROXY: &str = "";
const DEVKEY: &str = "";
const UA: &str = "";
const API_BASE: &str = "http://api.ttocr.com/api";

fn recognize_csdn() -> Result<Value, Box<dyn Error>> {
    let client = Client::builder().timeout(Duration::from_secs(60)).build()?;
    let mut params = HashMap::new();
    params.insert("appkey", APPKEY.to_string());
    params.insert("cookie", CSDN_COOKIE.to_string());
    params.insert("itemid", ITEM_ID.to_string());

    if !PROXY.is_empty() {
        params.insert("proxy", PROXY.to_string());
    }
    if !DEVKEY.is_empty() {
        params.insert("devkey", DEVKEY.to_string());
    }
    if !UA.is_empty() {
        params.insert("ua", UA.to_string());
    }

    let display_cookie = if CSDN_COOKIE.chars().count() > 20 {
        format!("{}...", &CSDN_COOKIE.chars().take(20).collect::<String>())
    } else {
        CSDN_COOKIE.to_string()
    };

    println!("[请求参数] cookie={}", display_cookie);
    println!("[请求参数] itemid={}", ITEM_ID);

    let result: Value = client
        .post(&format!("{}/recognize2", API_BASE))
        .form(&params)
        .send()?
        .json()?;

    if result["status"].as_i64() == Some(1) {
        println!("[成功] 识别成功!耗时:{}ms", result["time"]);
        println!("[识别结果] {}", result["data"]);
    } else {
        println!("[失败] 识别失败,错误信息:{}", result["msg"]);
        println!("[提示] 错误状态码:{},请参考错误代码表排查", result["status"]);
        println!("[提示] 如果结果无法通过验证,请将返回的 data 进行 urlencode 后再提交。");
    }

    println!(
        "\n[完整响应] {}",
        serde_json::to_string_pretty(&result).unwrap_or_else(|_| result.to_string())
    );

    Ok(result)
}

fn main() {
    println!("************************************************************");
    println!("  CSDN识别 Demo (Rust版)");
    println!("************************************************************");

    if APPKEY == "你的appkey" {
        println!("\n[错误] 请先在代码顶部的配置区域填写你的 APPKEY");
        process::exit(1);
    }
    if CSDN_COOKIE == "你获取到的cookie" {
        println!("\n[错误] 请先在代码顶部的配置区域填写 CSDN_COOKIE");
        process::exit(1);
    }

    println!("==================================================");
    println!("[CSDN识别] 正在提交CSDN识别任务...");
    println!("==================================================");

    if let Err(error) = recognize_csdn() {
        println!("[异常] 网络请求出错:{}", error);
        process::exit(1);
    }

    println!("\n==================================================");
    println!("[完成] 识别执行完毕");
    println!("==================================================");
}

C#

共 2 个示例,按接口动作拆分。

该语言注意事项

跟随当前语言展示
  • ============================================================== CSDN识别 对接示例 — C#版 使用说明 ============================================================== 【一、环境准备】 方式一:使用 .NET SDK(推荐) 1. 下载地址:https://dotnet.microsoft.com/download 2. 建议版本:.NET 6.0 或以上 3. 安装完成后,打开命令行验证: dotnet --version 方式二:使用 csc.exe 编译器 1. 安装 Visual Studio(社区版免费) 2. 或者安装 .NET Framework SDK 3. csc.exe 通常位于: C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe -------------------------------------------------------------- 【二、参数配置】 本Demo包含两个独立源文件: - QueryPoints.cs — 查询账户剩余点数 - RecognizeCsdn.cs — 提交CSDN验证码识别 请根据需要打开对应的源文件,找到顶部的"配置区域",修改以下参数: 1. APPKEY(必填) - 你的用户密钥,登录平台后在个人中心获取 - 示例:static string APPKEY = "abc123def456"; 2. CSDN_COOKIE(必填) - CSDN验证码的 waf_captcha_marker cookie字段值 - 需要从浏览器开发者工具(F12)中获取 - 打开浏览器 → F12 → Application/应用 → Cookies → 找到 waf_captcha_marker 字段 - 示例:static string CSDN_COOKIE = "39f8d06301c63ecc990e..."; 3. ITEM_ID(一般不需要改) - CSDN类型固定填写 600 4. PROXY(可选) - 代理IP地址,支持的格式: * http://IP:端口 (普通HTTP代理,若需白名单支持请联系客服) * http://账号:密码@proxy.com:8080 (带认证的HTTP代理) * socks5://127.0.0.1:9888 (SOCKS5代理) 5. DEVKEY(可选) - 开发者密钥 6. UA(可选) - User-Agent值 -------------------------------------------------------------- 【三、编译与运行】 方式一:使用 csc.exe 1. 打开"开发者命令提示符"(Developer Command Prompt) 2. 切换到源文件所在目录: cd CSDN\csharp 3. 编译查询点数:csc /out:QueryPoints.exe QueryPoints.cs 4. 运行:QueryPoints.exe 5. 编译CSDN识别:csc /out:RecognizeCsdn.exe RecognizeCsdn.cs 6. 运行:RecognizeCsdn.exe 方式二:使用 dotnet 1. 创建项目后将源文件放入,使用 dotnet run 运行 -------------------------------------------------------------- 【四、常见问题】 Q1:编译时提示 "csc 不是内部或外部命令" A1:请使用完整路径调用csc.exe,或者安装 .NET SDK 后使用 dotnet run Q2:编译时提示找不到 System.Web 命名空间 A2:使用csc编译时需要引用System.Web.dll: csc /r:System.Web.dll /out:RecognizeCsdn.exe RecognizeCsdn.cs Q3:查询点数成功但识别失败 A3:请检查 CSDN_COOKIE 是否正确,cookie值需要实时获取 Q4:返回的结果无法通过验证 A4:尝试对返回的 data 值进行 Uri.EscapeDataString() 编码后再使用 -------------------------------------------------------------- 【五、重要注意事项】 1. 查询点数接口有频率限制:不得超过1秒1次,否则会被拉黑24小时 2. 源文件必须使用 UTF-8 编码保存 3. 不要将你的 APPKEY 泄露给他人 4. 请确保你的账户有足够的点数余额 5. 目前CSDN识别支持文字点选,若需其他类型请联系客服 6. 如果提交结果失败无法通过,请将结果URL编码后提交 ==============================================================

查询点数

QueryPoints.cs

下载源码
QueryPoints.cs

C#

using System;
using System.IO;
using System.Net;
using System.Text;

/// <summary>
/// =============================================================
///   查询账户点数 Demo (C#版)
///
///   功能说明:
///   查询账户剩余点数(余额)
///
///   使用方法:
///   1. 将下方的 APPKEY 替换为你自己的用户密钥
///   2. 编译运行:csc QueryPoints.cs && QueryPoints.exe
///      或使用 dotnet run
/// =============================================================
/// </summary>
class QueryPoints
{
    // ======================== 配置区域(请替换为你自己的参数)========================
    // 用户密钥,登录平台后获取
    static string APPKEY = "你的appkey";
    // ===============================================================================

    // API基础地址
    static string API_BASE = "http://api.ttocr.com/api";

    /// <summary>
    /// 发送GET请求
    /// </summary>
    static string HttpGet(string url)
    {
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
        request.Method = "GET";
        request.Timeout = 10000;
        using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
        using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
        {
            return reader.ReadToEnd();
        }
    }

    static void Main(string[] args)
    {
        Console.OutputEncoding = Encoding.UTF8;
        Console.WriteLine(new string('*', 60));
        Console.WriteLine("  查询账户点数 Demo (C#版)");
        Console.WriteLine(new string('*', 60));

        // 检查参数是否已配置
        if (APPKEY == "你的appkey")
        {
            Console.WriteLine("\n[错误] 请先在代码顶部的配置区域填写你的 APPKEY");
            Environment.Exit(1);
        }

        Console.WriteLine(new string('=', 50));
        Console.WriteLine("[查询点数] 正在查询账户剩余点数...");
        Console.WriteLine(new string('=', 50));
        try
        {
            string url = API_BASE + "/points?appkey=" + Uri.EscapeDataString(APPKEY);
            string result = HttpGet(url);
            Console.WriteLine("[完整响应] " + result);
        }
        catch (Exception e)
        {
            Console.WriteLine("[异常] 网络请求出错:" + e.Message);
        }

        Console.WriteLine();
        Console.WriteLine(new string('=', 50));
        Console.WriteLine("[完成] 查询执行完毕");
        Console.WriteLine(new string('=', 50));
    }
}

提交识别

RecognizeCsdn.cs

下载源码
RecognizeCsdn.cs

C#

using System;
using System.IO;
using System.Net;
using System.Text;

/// <summary>
/// =============================================================
///   CSDN识别 Demo (C#版)
///
///   功能说明:
///   提交CSDN验证码识别任务(目前支持文字点选)
///
///   使用方法:
///   1. 将下方的 APPKEY 替换为你自己的用户密钥
///   2. 将 CSDN_COOKIE 替换为你获取到的 waf_captcha_marker cookie值
///   3. 编译运行:csc RecognizeCsdn.cs && RecognizeCsdn.exe
///      或使用 dotnet run
/// =============================================================
/// </summary>
class RecognizeCsdn
{
    // ======================== 配置区域(请替换为你自己的参数)========================
    // 用户密钥,登录平台后获取
    static string APPKEY = "你的appkey";

    // CSDN验证码的 waf_captcha_marker cookie字段值(从浏览器抓包获取)
    static string CSDN_COOKIE = "你获取到的cookie";

    // 项目类型,CSDN固定填写 600(特殊类型请联系客服)
    static int ITEM_ID = 600;

    // 可选参数:代理IP(格式示例:http://IP:端口,若需白名单支持请联系客服。http://账号:密码@proxy.com:8080 或 socks5://127.0.0.1:9888)
    static string PROXY = "";

    // 可选参数:开发者密钥(如果有的话填写)
    static string DEVKEY = "";

    // 可选参数:User-Agent(如果需要的话填写)
    static string UA = "";
    // ===============================================================================

    // API基础地址
    static string API_BASE = "http://api.ttocr.com/api";

    /// <summary>
    /// 发送POST请求(表单数据)
    /// </summary>
    static string HttpPost(string url, string postData)
    {
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
        request.Method = "POST";
        request.ContentType = "application/x-www-form-urlencoded";
        request.Timeout = 120000; // 识别可能需要较长时间
        byte[] data = Encoding.UTF8.GetBytes(postData);
        request.ContentLength = data.Length;
        using (Stream stream = request.GetRequestStream())
        {
            stream.Write(data, 0, data.Length);
        }
        using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
        using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
        {
            return reader.ReadToEnd();
        }
    }

    static void Main(string[] args)
    {
        Console.OutputEncoding = Encoding.UTF8;
        Console.WriteLine(new string('*', 60));
        Console.WriteLine("  CSDN识别 Demo (C#版)");
        Console.WriteLine(new string('*', 60));

        // 检查参数是否已配置
        if (APPKEY == "你的appkey")
        {
            Console.WriteLine("\n[错误] 请先在代码顶部的配置区域填写你的 APPKEY");
            Environment.Exit(1);
        }
        if (CSDN_COOKIE == "你获取到的cookie")
        {
            Console.WriteLine("\n[错误] 请先在代码顶部的配置区域填写 CSDN_COOKIE");
            Environment.Exit(1);
        }

        Console.WriteLine(new string('=', 50));
        Console.WriteLine("[CSDN识别] 正在提交CSDN识别任务...");
        Console.WriteLine(new string('=', 50));
        try
        {
            string url = API_BASE + "/recognize2";
            // 构建POST请求数据
            StringBuilder postData = new StringBuilder();
            postData.Append("appkey=").Append(Uri.EscapeDataString(APPKEY));
            postData.Append("&cookie=").Append(Uri.EscapeDataString(CSDN_COOKIE));
            postData.Append("&itemid=").Append(ITEM_ID);
            // 如果设置了代理,则添加代理参数
            if (!string.IsNullOrEmpty(PROXY))
            {
                postData.Append("&proxy=").Append(Uri.EscapeDataString(PROXY));
            }
            // 如果设置了开发者密钥,则添加
            if (!string.IsNullOrEmpty(DEVKEY))
            {
                postData.Append("&devkey=").Append(Uri.EscapeDataString(DEVKEY));
            }
            // 如果设置了UA,则添加
            if (!string.IsNullOrEmpty(UA))
            {
                postData.Append("&ua=").Append(Uri.EscapeDataString(UA));
            }
            Console.WriteLine("[请求参数] cookie=" + CSDN_COOKIE.Substring(0, Math.Min(20, CSDN_COOKIE.Length)) + "...");
            Console.WriteLine("[请求参数] itemid=" + ITEM_ID);
            string result = HttpPost(url, postData.ToString());
            Console.WriteLine("[完整响应] " + result);
        }
        catch (Exception e)
        {
            Console.WriteLine("[异常] 网络请求出错:" + e.Message);
        }

        Console.WriteLine();
        Console.WriteLine(new string('=', 50));
        Console.WriteLine("[完成] 识别执行完毕");
        Console.WriteLine(new string('=', 50));
    }
}

C++

共 2 个示例,按接口动作拆分。

该语言注意事项

跟随当前语言展示
  • ============================================================== CSDN识别 对接示例 — C++版 使用说明 ============================================================== 【一、环境准备】 1. 安装 g++ - Ubuntu 可执行: sudo apt-get install g++ 2. 安装 libcurl 开发库 - Ubuntu 可执行: sudo apt-get install libcurl4-openssl-dev -------------------------------------------------------------- 【二、参数配置】 本 Demo 包含两个独立脚本: - QueryPoints.cpp — 查询账户剩余点数 - RecognizeCsdn.cpp — 提交 CSDN 验证码识别 需要重点填写: 1. APPKEY 2. CSDN_COOKIE 3. ITEM_ID 固定为 600 4. PROXY / DEVKEY / UA 可按需填写 -------------------------------------------------------------- 【三、运行方式】 1. 查询点数: g++ -std=c++11 QueryPoints.cpp -lcurl -o query_points ./query_points 2. CSDN识别: g++ -std=c++11 RecognizeCsdn.cpp -lcurl -o recognize_csdn ./recognize_csdn -------------------------------------------------------------- 【四、常见问题】 Q1:编译时报找不到 curl/curl.h A1:说明 libcurl 开发库未安装,请先安装 libcurl4-openssl-dev Q2:返回结果无法通过目标网站验证 A2:请将返回的 data 进行 urlencode 后再提交 Q3:提示网络请求出错 A3:请检查网络、代理或 UA 是否需要同步目标站环境 -------------------------------------------------------------- 【五、重要注意事项】 1. 查询点数接口不得超过 1 秒 1 次,否则会被拉黑 24 小时 2. 识别接口超时时间为 60 秒,请耐心等待结果 3. 不要将 APPKEY 泄露给他人 4. 请确保账户点数余额充足 5. 目前 CSDN 识别支持文字点选,其他类型请联系客服 ==============================================================

查询点数

QueryPoints.cpp

下载源码
QueryPoints.cpp

C++

#include <curl/curl.h>
#include <cctype>
#include <cstdlib>
#include <iostream>
#include <stdexcept>
#include <string>

/*
=============================================================
  查询账户点数 Demo (C++版)

  功能说明:
  查询账户剩余点数(余额)

  使用方法:
  1. 确保已安装 g++ 和 libcurl 开发库
  2. 将下方的 APPKEY 替换为你自己的用户密钥
  3. 编译运行:
       g++ -std=c++11 QueryPoints.cpp -lcurl -o query_points
       ./query_points
=============================================================
*/

const std::string APPKEY = "你的appkey";
const std::string API_BASE = "http://api.ttocr.com/api";

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, void* userp) {
    size_t total = size * nmemb;
    static_cast<std::string*>(userp)->append(static_cast<char*>(contents), total);
    return total;
}

std::string Trim(const std::string& input) {
    size_t start = 0;
    while (start < input.size() && std::isspace(static_cast<unsigned char>(input[start]))) {
        ++start;
    }

    size_t end = input.size();
    while (end > start && std::isspace(static_cast<unsigned char>(input[end - 1]))) {
        --end;
    }

    return input.substr(start, end - start);
}

std::string StripQuotes(const std::string& input) {
    if (input.size() >= 2 && input.front() == '"' && input.back() == '"') {
        return input.substr(1, input.size() - 2);
    }
    return input;
}

std::string ExtractJsonValue(const std::string& json, const std::string& key) {
    std::string needle = "\"" + key + "\"";
    size_t keyPos = json.find(needle);
    if (keyPos == std::string::npos) {
        return "";
    }

    size_t colon = json.find(':', keyPos + needle.size());
    if (colon == std::string::npos) {
        return "";
    }

    size_t pos = colon + 1;
    while (pos < json.size() && std::isspace(static_cast<unsigned char>(json[pos]))) {
        ++pos;
    }

    bool inString = false;
    bool escaped = false;
    int braceDepth = 0;
    int bracketDepth = 0;
    size_t end = pos;

    for (; end < json.size(); ++end) {
        char ch = json[end];
        if (inString) {
            if (escaped) {
                escaped = false;
                continue;
            }
            if (ch == '\\') {
                escaped = true;
                continue;
            }
            if (ch == '"') {
                inString = false;
            }
            continue;
        }

        if (ch == '"') {
            inString = true;
            continue;
        }
        if (ch == '{') {
            ++braceDepth;
            continue;
        }
        if (ch == '}') {
            if (braceDepth == 0 && bracketDepth == 0) {
                break;
            }
            --braceDepth;
            continue;
        }
        if (ch == '[') {
            ++bracketDepth;
            continue;
        }
        if (ch == ']') {
            --bracketDepth;
            continue;
        }
        if (ch == ',' && braceDepth == 0 && bracketDepth == 0) {
            break;
        }
    }

    return Trim(json.substr(pos, end - pos));
}

bool IsSuccessStatus(const std::string& json) {
    return ExtractJsonValue(json, "status") == "1";
}

std::string HttpGet(const std::string& url) {
    CURL* curl = curl_easy_init();
    if (!curl) {
        throw std::runtime_error("初始化 CURL 失败");
    }

    std::string response;
    curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
    curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

    CURLcode code = curl_easy_perform(curl);
    curl_easy_cleanup(curl);

    if (code != CURLE_OK) {
        throw std::runtime_error(curl_easy_strerror(code));
    }

    return response;
}

int main() {
    std::cout << "************************************************************" << std::endl;
    std::cout << "  查询账户点数 Demo (C++版)" << std::endl;
    std::cout << "************************************************************" << std::endl;

    if (APPKEY == "你的appkey") {
        std::cout << "\n[错误] 请先在代码顶部的配置区域填写你的 APPKEY" << std::endl;
        return 1;
    }

    curl_global_init(CURL_GLOBAL_DEFAULT);

    std::cout << "==================================================" << std::endl;
    std::cout << "[查询点数] 正在查询账户剩余点数..." << std::endl;
    std::cout << "==================================================" << std::endl;

    try {
        CURL* encoder = curl_easy_init();
        char* escaped = curl_easy_escape(encoder, APPKEY.c_str(), static_cast<int>(APPKEY.size()));
        std::string url = API_BASE + "/points?appkey=" + (escaped ? escaped : "");
        if (escaped) {
            curl_free(escaped);
        }
        curl_easy_cleanup(encoder);

        std::string result = HttpGet(url);
        if (IsSuccessStatus(result)) {
            std::cout << "[成功] 查询成功!当前可用点数:" << StripQuotes(ExtractJsonValue(result, "points")) << std::endl;
        } else {
            std::cout << "[失败] 查询失败,错误信息:" << StripQuotes(ExtractJsonValue(result, "msg")) << std::endl;
            std::cout << "[提示] 错误状态码:" << ExtractJsonValue(result, "status") << ",请参考错误代码表排查" << std::endl;
        }
        std::cout << "[完整响应] " << result << std::endl;
    } catch (const std::exception& error) {
        std::cout << "[异常] 网络请求出错:" << error.what() << std::endl;
        curl_global_cleanup();
        return 1;
    }

    curl_global_cleanup();

    std::cout << "\n==================================================" << std::endl;
    std::cout << "[完成] 查询执行完毕" << std::endl;
    std::cout << "==================================================" << std::endl;
    return 0;
}

提交识别

RecognizeCsdn.cpp

下载源码
RecognizeCsdn.cpp

C++

#include <curl/curl.h>
#include <cctype>
#include <cstdlib>
#include <iostream>
#include <stdexcept>
#include <string>

/*
=============================================================
  CSDN识别 Demo (C++版)

  功能说明:
  提交CSDN验证码识别任务(目前支持文字点选)

  使用方法:
  1. 确保已安装 g++ 和 libcurl 开发库
  2. 将下方的 APPKEY / CSDN_COOKIE 替换为你自己的值
  3. 编译运行:
       g++ -std=c++11 RecognizeCsdn.cpp -lcurl -o recognize_csdn
       ./recognize_csdn
=============================================================
*/

const std::string APPKEY = "你的appkey";
const std::string CSDN_COOKIE = "你获取到的cookie";
const std::string ITEM_ID = "600";
const std::string PROXY = "";
const std::string DEVKEY = "";
const std::string UA = "";
const std::string API_BASE = "http://api.ttocr.com/api";

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, void* userp) {
    size_t total = size * nmemb;
    static_cast<std::string*>(userp)->append(static_cast<char*>(contents), total);
    return total;
}

std::string Trim(const std::string& input) {
    size_t start = 0;
    while (start < input.size() && std::isspace(static_cast<unsigned char>(input[start]))) {
        ++start;
    }

    size_t end = input.size();
    while (end > start && std::isspace(static_cast<unsigned char>(input[end - 1]))) {
        --end;
    }

    return input.substr(start, end - start);
}

std::string StripQuotes(const std::string& input) {
    if (input.size() >= 2 && input.front() == '"' && input.back() == '"') {
        return input.substr(1, input.size() - 2);
    }
    return input;
}

std::string ExtractJsonValue(const std::string& json, const std::string& key) {
    std::string needle = "\"" + key + "\"";
    size_t keyPos = json.find(needle);
    if (keyPos == std::string::npos) {
        return "";
    }

    size_t colon = json.find(':', keyPos + needle.size());
    if (colon == std::string::npos) {
        return "";
    }

    size_t pos = colon + 1;
    while (pos < json.size() && std::isspace(static_cast<unsigned char>(json[pos]))) {
        ++pos;
    }

    bool inString = false;
    bool escaped = false;
    int braceDepth = 0;
    int bracketDepth = 0;
    size_t end = pos;

    for (; end < json.size(); ++end) {
        char ch = json[end];
        if (inString) {
            if (escaped) {
                escaped = false;
                continue;
            }
            if (ch == '\\') {
                escaped = true;
                continue;
            }
            if (ch == '"') {
                inString = false;
            }
            continue;
        }

        if (ch == '"') {
            inString = true;
            continue;
        }
        if (ch == '{') {
            ++braceDepth;
            continue;
        }
        if (ch == '}') {
            if (braceDepth == 0 && bracketDepth == 0) {
                break;
            }
            --braceDepth;
            continue;
        }
        if (ch == '[') {
            ++bracketDepth;
            continue;
        }
        if (ch == ']') {
            --bracketDepth;
            continue;
        }
        if (ch == ',' && braceDepth == 0 && bracketDepth == 0) {
            break;
        }
    }

    return Trim(json.substr(pos, end - pos));
}

bool IsSuccessStatus(const std::string& json) {
    return ExtractJsonValue(json, "status") == "1";
}

void AppendFormField(CURL* curl, std::string& postData, const std::string& key, const std::string& value) {
    char* escaped = curl_easy_escape(curl, value.c_str(), static_cast<int>(value.size()));
    if (!postData.empty()) {
        postData += "&";
    }
    postData += key + "=" + (escaped ? escaped : "");
    if (escaped) {
        curl_free(escaped);
    }
}

std::string HttpPost(const std::string& url, const std::string& postData, long timeoutSeconds) {
    CURL* curl = curl_easy_init();
    if (!curl) {
        throw std::runtime_error("初始化 CURL 失败");
    }

    std::string response;
    curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
    curl_easy_setopt(curl, CURLOPT_POST, 1L);
    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData.c_str());
    curl_easy_setopt(curl, CURLOPT_TIMEOUT, timeoutSeconds);
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

    struct curl_slist* headers = NULL;
    headers = curl_slist_append(headers, "Content-Type: application/x-www-form-urlencoded");
    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

    CURLcode code = curl_easy_perform(curl);
    curl_slist_free_all(headers);
    curl_easy_cleanup(curl);

    if (code != CURLE_OK) {
        throw std::runtime_error(curl_easy_strerror(code));
    }

    return response;
}

int main() {
    std::cout << "************************************************************" << std::endl;
    std::cout << "  CSDN识别 Demo (C++版)" << std::endl;
    std::cout << "************************************************************" << std::endl;

    if (APPKEY == "你的appkey") {
        std::cout << "\n[错误] 请先在代码顶部的配置区域填写你的 APPKEY" << std::endl;
        return 1;
    }
    if (CSDN_COOKIE == "你获取到的cookie") {
        std::cout << "\n[错误] 请先在代码顶部的配置区域填写 CSDN_COOKIE" << std::endl;
        return 1;
    }

    curl_global_init(CURL_GLOBAL_DEFAULT);

    std::cout << "==================================================" << std::endl;
    std::cout << "[CSDN识别] 正在提交CSDN识别任务..." << std::endl;
    std::cout << "==================================================" << std::endl;

    try {
        CURL* encoder = curl_easy_init();
        std::string postData;
        AppendFormField(encoder, postData, "appkey", APPKEY);
        AppendFormField(encoder, postData, "cookie", CSDN_COOKIE);
        AppendFormField(encoder, postData, "itemid", ITEM_ID);
        if (!PROXY.empty()) {
            AppendFormField(encoder, postData, "proxy", PROXY);
        }
        if (!DEVKEY.empty()) {
            AppendFormField(encoder, postData, "devkey", DEVKEY);
        }
        if (!UA.empty()) {
            AppendFormField(encoder, postData, "ua", UA);
        }
        curl_easy_cleanup(encoder);

        std::string displayCookie = CSDN_COOKIE.size() > 20 ? CSDN_COOKIE.substr(0, 20) + "..." : CSDN_COOKIE;
        std::cout << "[请求参数] cookie=" << displayCookie << std::endl;
        std::cout << "[请求参数] itemid=" << ITEM_ID << std::endl;

        std::string result = HttpPost(API_BASE + "/recognize2", postData, 60L);
        if (IsSuccessStatus(result)) {
            std::cout << "[成功] 识别成功!耗时:" << StripQuotes(ExtractJsonValue(result, "time")) << "ms" << std::endl;
            std::cout << "[识别结果] " << StripQuotes(ExtractJsonValue(result, "data")) << std::endl;
        } else {
            std::cout << "[失败] 识别失败,错误信息:" << StripQuotes(ExtractJsonValue(result, "msg")) << std::endl;
            std::cout << "[提示] 错误状态码:" << ExtractJsonValue(result, "status") << ",请参考错误代码表排查" << std::endl;
            std::cout << "[提示] 如果结果无法通过验证,请将返回的 data 进行 urlencode 后再提交。" << std::endl;
        }
        std::cout << "\n[完整响应] " << result << std::endl;
    } catch (const std::exception& error) {
        std::cout << "[异常] 网络请求出错:" << error.what() << std::endl;
        curl_global_cleanup();
        return 1;
    }

    curl_global_cleanup();

    std::cout << "\n==================================================" << std::endl;
    std::cout << "[完成] 识别执行完毕" << std::endl;
    std::cout << "==================================================" << std::endl;
    return 0;
}

PHP

共 2 个示例,按接口动作拆分。

该语言注意事项

跟随当前语言展示
  • ============================================================== CSDN识别 对接示例 — PHP版 使用说明 ============================================================== 【一、环境准备】 1. 安装 PHP - Windows下载地址:https://windows.php.net/download/ - 建议版本:PHP 7.0 或以上(推荐 8.0+) - 下载后解压到任意目录(如 C:\php) - 将PHP目录添加到系统 PATH 环境变量 - 打开命令行验证: php --version 2. 启用 curl 扩展 - 打开 PHP 安装目录下的 php.ini 文件 - 找到 ;extension=curl 这一行 - 去掉前面的分号,改为:extension=curl - 保存文件后重新打开命令行验证: php -m | findstr curl 如果显示 "curl" 则启用成功 -------------------------------------------------------------- 【二、参数配置】 本Demo包含两个独立脚本: - query_points.php — 查询账户剩余点数 - recognize_csdn.php — 提交CSDN验证码识别 请根据需要打开对应的脚本文件,找到顶部的"配置区域",修改以下参数: 1. $APPKEY(必填) - 你的用户密钥,登录平台后在个人中心获取 - 示例:$APPKEY = "abc123def456"; 2. $CSDN_COOKIE(必填) - CSDN验证码的 waf_captcha_marker cookie字段值 - 需要从浏览器开发者工具(F12)中获取 - 打开浏览器 → F12 → Application/应用 → Cookies → 找到 waf_captcha_marker 字段 - 示例:$CSDN_COOKIE = "39f8d06301c63ecc990e..."; 3. $ITEM_ID(一般不需要改) - CSDN类型固定填写 600 4. $PROXY(可选) - 代理IP地址,支持的格式: * http://IP:端口 (普通HTTP代理,若需白名单支持请联系客服) * http://账号:密码@proxy.com:8080 (带认证的HTTP代理) * socks5://127.0.0.1:9888 (SOCKS5代理) 5. $DEVKEY(可选) - 开发者密钥 6. $UA(可选) - User-Agent值 -------------------------------------------------------------- 【三、运行方式】 1. 打开命令行(cmd 或 PowerShell) 2. 切换到脚本所在目录: cd CSDN\php 查询点数: 3. 执行:php query_points.php CSDN识别: 4. 执行:php recognize_csdn.php 5. 识别结果会在控制台中显示 -------------------------------------------------------------- 【四、常见问题】 Q1:运行时提示 "php 不是内部或外部命令" A1:PHP未安装或未添加到系统PATH,请参考【一、环境准备】 Q2:运行时提示 curl 相关错误 A2:请确认已在 php.ini 中启用 curl 扩展 Q3:查询点数成功但识别失败 A3:请检查 $CSDN_COOKIE 是否正确,cookie值需要实时获取 Q4:返回的结果无法通过验证 A4:尝试对返回的 data 值进行 urlencode() 编码后再使用 -------------------------------------------------------------- 【五、重要注意事项】 1. 查询点数接口有频率限制:不得超过1秒1次,否则会被拉黑24小时 2. 需要PHP启用curl扩展才能正常运行 3. 不要将你的 APPKEY 泄露给他人 4. 请确保你的账户有足够的点数余额 5. 目前CSDN识别支持文字点选,若需其他类型请联系客服 6. 如果提交结果失败无法通过,请将结果URL编码后提交 ==============================================================

查询点数

query_points.php

下载源码
query_points.php

PHP

<?php
/**
 * =============================================================
 *   查询账户点数 Demo (PHP版)
 *
 *   功能说明:
 *   查询账户剩余点数(余额)
 *
 *   使用方法:
 *   1. 确保PHP已安装并启用curl扩展
 *   2. 将下方的 APPKEY 替换为你自己的用户密钥
 *   3. 运行脚本:php query_points.php
 * =============================================================
 */

// ======================== 配置区域(请替换为你自己的参数)========================
// 用户密钥,登录平台后获取
$APPKEY = "你的appkey";
// ===============================================================================

// API基础地址
$API_BASE = "http://api.ttocr.com/api";

// ======================== 主流程 ========================
echo str_repeat("*", 60) . "\n";
echo "  查询账户点数 Demo (PHP版)\n";
echo str_repeat("*", 60) . "\n";

// 检查参数是否已配置
if ($APPKEY === "你的appkey") {
    echo "\n[错误] 请先在脚本顶部的配置区域填写你的 APPKEY\n";
    exit(1);
}

echo str_repeat("=", 50) . "\n";
echo "[查询点数] 正在查询账户剩余点数...\n";
echo str_repeat("=", 50) . "\n";

$url = $API_BASE . "/points?appkey=" . urlencode($APPKEY);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo "[异常] 网络请求出错:" . curl_error($ch) . "\n";
    curl_close($ch);
    exit(1);
}
curl_close($ch);

$result = json_decode($response, true);
if ($result['status'] == 1) {
    echo "[成功] 查询成功!当前可用点数:" . $result['points'] . "\n";
} else {
    echo "[失败] 查询失败,错误信息:" . $result['msg'] . "\n";
    echo "[提示] 错误状态码:" . $result['status'] . ",请参考错误代码表排查\n";
}
echo "[完整响应] " . json_encode($result, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT) . "\n";

echo "\n" . str_repeat("=", 50) . "\n";
echo "[完成] 查询执行完毕\n";
echo str_repeat("=", 50) . "\n";
?>

提交识别

recognize_csdn.php

下载源码
recognize_csdn.php

PHP

<?php
/**
 * =============================================================
 *   CSDN识别 Demo (PHP版)
 *
 *   功能说明:
 *   提交CSDN验证码识别任务(目前支持文字点选)
 *
 *   使用方法:
 *   1. 确保PHP已安装并启用curl扩展
 *   2. 将下方的 APPKEY 替换为你自己的用户密钥
 *   3. 将 CSDN_COOKIE 替换为你获取到的 waf_captcha_marker cookie值
 *   4. 运行脚本:php recognize_csdn.php
 * =============================================================
 */

// ======================== 配置区域(请替换为你自己的参数)========================
// 用户密钥,登录平台后获取
$APPKEY = "你的appkey";

// CSDN验证码的 waf_captcha_marker cookie字段值(从浏览器抓包获取)
$CSDN_COOKIE = "你获取到的cookie";

// 项目类型,CSDN固定填写 600(特殊类型请联系客服)
$ITEM_ID = 600;

// 可选参数:代理IP(格式示例:http://IP:端口,若需白名单支持请联系客服。http://账号:密码@proxy.com:8080 或 socks5://127.0.0.1:9888)
$PROXY = "";

// 可选参数:开发者密钥(如果有的话填写)
$DEVKEY = "";

// 可选参数:User-Agent(如果需要的话填写)
$UA = "";
// ===============================================================================

// API基础地址
$API_BASE = "http://api.ttocr.com/api";

// ======================== 主流程 ========================
echo str_repeat("*", 60) . "\n";
echo "  CSDN识别 Demo (PHP版)\n";
echo str_repeat("*", 60) . "\n";

// 检查参数是否已配置
if ($APPKEY === "你的appkey") {
    echo "\n[错误] 请先在脚本顶部的配置区域填写你的 APPKEY\n";
    exit(1);
}
if ($CSDN_COOKIE === "你获取到的cookie") {
    echo "\n[错误] 请先在脚本顶部的配置区域填写 CSDN_COOKIE\n";
    exit(1);
}

echo str_repeat("=", 50) . "\n";
echo "[CSDN识别] 正在提交CSDN识别任务...\n";
echo str_repeat("=", 50) . "\n";

$url = $API_BASE . "/recognize2";

// 构建POST请求数据
$postData = array(
    'appkey' => $APPKEY,
    'cookie' => $CSDN_COOKIE,
    'itemid' => $ITEM_ID,
);
// 如果设置了代理,则添加代理参数
if (!empty($PROXY)) {
    $postData['proxy'] = $PROXY;
}
// 如果设置了开发者密钥,则添加
if (!empty($DEVKEY)) {
    $postData['devkey'] = $DEVKEY;
}
// 如果设置了UA,则添加
if (!empty($UA)) {
    $postData['ua'] = $UA;
}

$cookieDisplay = strlen($CSDN_COOKIE) > 20 ? substr($CSDN_COOKIE, 0, 20) . "..." : $CSDN_COOKIE;
echo "[请求参数] cookie=" . $cookieDisplay . "\n";
echo "[请求参数] itemid=" . $ITEM_ID . "\n";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120); // 识别可能需要较长时间

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo "[异常] 网络请求出错:" . curl_error($ch) . "\n";
    curl_close($ch);
    exit(1);
}
curl_close($ch);

$result = json_decode($response, true);
if ($result['status'] == 1) {
    echo "[成功] 识别成功!耗时:" . $result['time'] . "ms\n";
    echo "[识别结果] " . $result['data'] . "\n";
} else {
    echo "[失败] 识别失败,错误信息:" . $result['msg'] . "\n";
    echo "[提示] 错误状态码:" . $result['status'] . ",请参考错误代码表排查\n";
}
echo "\n[完整响应] " . json_encode($result, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT) . "\n";

echo "\n" . str_repeat("=", 50) . "\n";
echo "[完成] 识别执行完毕\n";
echo str_repeat("=", 50) . "\n";
?>