1. C 遍历游标到底在遍历什么先把概念说清楚C 语言本身没有“游标”这个语法游标是数据库或文件系统提供的一种“逐条推进”的读取机制。你在 C 里写遍历游标本质是调用某个库暴露的 API让它在结果集或数据流上维护一个位置指针你每次取一条、指针往前挪一格直到取空为止。常见的三种形态是数据库结果集游标libpq、MySQL Connector/C、ODBC、文件流游标fseek/ftell 配合循环、以及自定义结构体里的索引游标比如链表遍历时那个cur指针。这篇面向的是需要在本地工具链里统一管理 API Key 的开发者。你可能会用 C 写一个数据导出小工具、一个批量调用模型接口的 CLI或者一个把数据库游标结果转成 JSON 再发给大模型的管道程序。这些场景里代码逻辑是一部分另一部分很容易被忽略你的程序要访问外部 APIKey 放哪、怎么读、怎么保证不硬编码进源码。我试过把 Key 直接写进.c文件提交一次就后悔了后来统一收进settings.json由程序启动时读取。所以这篇的闭环是先用settings.json把 TaoToken 的统一 Key 和 API 通道地址配好再写一段 C 遍历游标的代码最后跑一次验证确认“配置读取 → 游标遍历 → 发起请求”这条链路是通的。适合已经会写基础 C、但对配置管理和接口调用还不太熟的人。TaoToken 在这里的角色是统一入口你不需要为每个模型或工具分别记一套地址和 Key而是用同一个 Key、同一个 API 通道地址https://taotoken.net/api去对接。官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 需要看文档或开 Key 从这里进。2. 前置TaoToken 统一 Key 与 settings.json 骨架在写 C 代码之前先把配置这件事做扎实。核心思路是程序不直接持有 Key而是从一个 JSON 配置文件里读。这样你换 Key、换环境、换通道地址时只改配置不改代码。先拿到统一 Key。进入控制台创建 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 创建后复制那串 Key形如sk-开头的一长串。这个 Key 就是你后面所有调用的凭证。然后建一个settings.json放在项目根目录或用户配置目录都行。骨架如下{ api: { base_url: https://taotoken.net/api, api_key: sk-你的统一Key, timeout_ms: 30000, model: claude-sonnet-4-5 }, cursor: { batch_size: 100, max_rows: 10000, log_every: 500 }, db: { conninfo: hostlocalhost port5432 dbnamemydatabase usermyuser passwordmypassword } }几个字段说明一下。base_url固定写https://taotoken.net/api这是 API 通道地址注意不要在后面多加斜杠或路径拼接时由代码负责。api_key填你刚创建的那串。timeout_ms是请求超时遍历游标时如果每批都要发请求超时太短容易误判失败。cursor.batch_size控制每次从游标取多少条max_rows是安全上限防止无限循环。db.conninfo是数据库连接串和游标遍历直接相关。注意settings.json不要提交到公开仓库。把它加进.gitignore或者用settings.example.json做模板真实文件本地保留。Key 泄露的代价比你想的高。如果你更习惯用环境变量兜底可以在代码里做一层先读settings.json读不到api_key就回退到环境变量TAOTOKEN_API_KEY。这样 CI 环境里不用放文件。3. 可复制配置C 读取 settings.json 并遍历游标这一节给完整可编译的代码。为了不引入额外 JSON 库依赖我用一个极简的解析方式按行扫描、定位 key。生产环境建议换成 cJSON 或 jansson但作为可跟做的示例这样最省事。先看读取配置的部分#include stdio.h #include stdlib.h #include string.h #define MAX_LINE 1024 typedef struct { char base_url[256]; char api_key[256]; char model[128]; int timeout_ms; int batch_size; int max_rows; char conninfo[512]; } Config; static void trim(char *s) { int len strlen(s); while (len 0 (s[len-1] \n || s[len-1] \r || s[len-1] || s[len-1] || s[len-1] ,)) { s[--len] \0; } } static int read_json_string(const char *line, const char *key, char *out, size_t out_size) { const char *p strstr(line, key); if (!p) return 0; p strchr(p, :); if (!p) return 0; p; while (*p || *p ) p; const char *end strchr(p, ); if (!end) return 0; size_t n (size_t)(end - p); if (n out_size) n out_size - 1; memcpy(out, p, n); out[n] \0; return 1; } static int read_json_int(const char *line, const char *key, int *out) { const char *p strstr(line, key); if (!p) return 0; p strchr(p, :); if (!p) return 0; *out atoi(p 1); return 1; } int load_config(const char *path, Config *cfg) { FILE *fp fopen(path, r); if (!fp) { fprintf(stderr, cannot open %s\n, path); return -1; } memset(cfg, 0, sizeof(*cfg)); cfg-timeout_ms 30000; cfg-batch_size 100; cfg-max_rows 10000; char line[MAX_LINE]; while (fgets(line, sizeof(line), fp)) { read_json_string(line, \base_url\, cfg-base_url, sizeof(cfg-base_url)); read_json_string(line, \api_key\, cfg-api_key, sizeof(cfg-api_key)); read_json_string(line, \model\, cfg-model, sizeof(cfg-model)); read_json_string(line, \conninfo\, cfg-conninfo, sizeof(cfg-conninfo)); read_json_int(line, \timeout_ms\, cfg-timeout_ms); read_json_int(line, \batch_size\, cfg-batch_size); read_json_int(line, \max_rows\, cfg-max_rows); } fclose(fp); if (cfg-base_url[0] \0) { strncpy(cfg-base_url, https://taotoken.net/api, sizeof(cfg-base_url) - 1); } if (cfg-api_key[0] \0) { const char *env getenv(TAOTOKEN_API_KEY); if (env) strncpy(cfg-api_key, env, sizeof(cfg-api_key) - 1); } return 0; }这段代码的关键点base_url和api_key都从配置读读不到才回退。trim处理行尾的逗号和引号避免解析出脏字符。接下来是游标遍历部分。这里用 libpq 的结果集遍历作为示例因为它最贴近“遍历游标”的语义PQntuples给总行数PQgetvalue按行列取值外层循环就是游标推进。#include libpq-fe.h int walk_cursor(const Config *cfg) { char conninfo[512]; snprintf(conninfo, sizeof(conninfo), %s, cfg-conninfo); PGconn *conn PQconnectdb(conninfo); if (PQstatus(conn) ! CONNECTION_OK) { fprintf(stderr, connect failed: %s\n, PQerrorMessage(conn)); PQfinish(conn); return -1; } PGresult *res PQexec(conn, SELECT id, name, payload FROM mytable ORDER BY id); if (PQresultStatus(res) ! PGRES_TUPLES_OK) { fprintf(stderr, query failed: %s\n, PQerrorMessage(conn)); PQclear(res); PQfinish(conn); return -1; } int total PQntuples(res); int fields PQnfields(res); int limit total cfg-max_rows ? total : cfg-max_rows; for (int row 0; row limit; row) { for (int col 0; col fields; col) { printf(%s%s , PQfname(res, col), PQgetvalue(res, row, col)); } printf(\n); if (cfg-batch_size 0 (row 1) % cfg-batch_size 0) { printf([cursor] advanced %d/%d rows\n, row 1, limit); } } PQclear(res); PQfinish(conn); return 0; }编译命令假设 libpq 已安装gcc -o walk_cursor main.c -I/usr/include/postgresql -lpq运行./walk_cursor到这里配置读取和游标遍历都齐了。下一步是把遍历出来的数据接到 API 调用上验证整条链路。4. 验证请求从游标数据到 API 调用成功光遍历出来还不够得确认配置里的base_url和api_key真的能用。最直接的办法是在游标遍历到第一条数据时拿它拼一个请求发给 TaoToken 的 API 通道看返回是否正常。下面这段用 libcurl 发一个最小请求。注意 URL 拼接base_url是https://taotoken.net/api具体路径由你调用的接口决定这里以模型对话接口为例拼接时用/连接。#include curl/curl.h static size_t write_cb(void *ptr, size_t size, size_t nmemb, void *userdata) { size_t total size * nmemb; fwrite(ptr, 1, total, stdout); return total; } int verify_api(const Config *cfg, const char *prompt) { CURL *curl curl_easy_init(); if (!curl) return -1; char url[512]; snprintf(url, sizeof(url), %s/v1/messages, cfg-base_url); char body[2048]; snprintf(body, sizeof(body), {\model\:\%s\,\max_tokens\:64, \messages\:[{\role\:\user\,\content\:\%s\}]}, cfg-model, prompt); struct curl_slist *headers NULL; char auth[512]; snprintf(auth, sizeof(auth), x-api-key: %s, cfg-api_key); headers curl_slist_append(headers, Content-Type: application/json); headers curl_slist_append(headers, auth); headers curl_slist_append(headers, anthropic-version: 2023-06-01); curl_easy_setopt(curl, CURLOPT_URL, url); curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers); curl_easy_setopt(curl, CURLOPT_POSTFIELDS, body); curl_easy_setopt(curl, CURLOPT_TIMEOUT_MS, (long)cfg-timeout_ms); curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_cb); CURLcode rc curl_easy_perform(curl); long http_code 0; curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, http_code); printf(\n[http] status%ld curl%d\n, http_code, rc); curl_slist_free_all(headers); curl_easy_cleanup(curl); return (rc CURLE_OK http_code 200) ? 0 : -1; }编译时加上 curlgcc -o walk_cursor main.c -I/usr/include/postgresql -lpq -lcurl把verify_api接到游标循环里取第一行的payload字段作为 promptif (row 0) { const char *payload PQgetvalue(res, 0, 2); verify_api(cfg, payload); }成功时你会看到类似输出先打印游标推进日志然后 API 返回一段 JSON最后一行是[http] status200 curl0。status200说明 Key 和通道地址都对curl0说明网络层没问题。如果返回 401多半是 Key 写错或没读到返回 404检查base_url拼接路径。提示验证阶段建议把max_rows临时设成 1只跑一条确认链路通了再放开全量遍历省得调试时刷屏。5. 本篇常见错排查配置读不到api_key为空。最常见的原因是 JSON 里 Key 那行格式不对比如少了引号、多了空格或者read_json_string匹配的 key 名和文件里不一致。排查方法在load_config末尾加一行printf(key len%zu\n, strlen(cfg-api_key));长度是 0 就说明没读到。另外确认settings.json的路径是程序运行目录下的相对路径不是源码目录。游标遍历越界或死循环。如果PQntuples返回负数或异常大通常是查询本身出错但没检查PQresultStatus。务必在PQexec后先判断状态再取行数。死循环多见于自己写的索引游标比如while (cur ! NULL)但忘了cur cur-next。加一个max_rows上限是最省事的保险。API 返回 401 或 403。先确认 Key 是从控制台新创建的、没有多余空格。再确认请求头字段名正确不同接口对鉴权头的要求可能不同以接入文档为准。文档入口在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 对照着检查 header 名和版本字段。返回 404 或连接超时。404 基本是 URL 拼错了检查base_url后面拼的路径是不是多了一层或少了一层。超时则看timeout_ms是不是设得太小遍历场景下每批都发请求网络抖动很正常30 秒起步比较稳。编译报找不到 libpq-fe.h 或 curl。这是环境问题不是代码问题。确认开发包已安装编译时-I指向头文件目录、-l链接对应库。不同系统包名不一样用包管理器查一下即可。6. 把 Key 管起来把游标跑通走到这里你应该已经跑通了完整链路settings.json提供统一 Key 和 API 通道地址C 程序读取配置游标逐行推进取出的数据能发到接口并拿到 200。这套结构的价值在于解耦——代码只管逻辑凭证和地址交给配置换环境时不用重新编译。如果你后面要长期写这类工具或者做 Agent 类的批量任务建议看一下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 适合需要稳定调用额度和统一管理的场景。只是想快速验证模型返回用模型对话页面更直接https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Key 的管理和创建都在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个实用习惯每次改完settings.json先跑一遍只取一行的验证确认status200再放开全量。游标遍历本身不难难的是配置和调用之间的那层衔接把它固定成模板后面每个 C 工具都能直接复用。
