在线调试
填写业务相关参数免费在线调试
专为短剧内容聚合设计的高效API接口,支持获取抖音平台热门短剧列表数据。提供20+精细分类筛选(爱情、剧情、逆袭、古装、悬疑等),满足不同内容场景需求。内置智能分页机制,单次可获取1-50部短剧信息,包含剧集详情、播放数据、更新状态等完整字段。返回标准化JSON数据结构,开箱即用,轻松集成到各类应用场景。
全站会员->单独包月->次数包->点数计费->账户余额->免费额度
全站会员有效期内,可免费使用本产品。
| 免费/测试用户请求频率限制 | 请求频率总限制 | 全站会员请求频率限制 | 每日请求次数总限制 |
|---|---|---|---|
| 3秒1次 每个免费用户的QPS总限制 | 1秒1次 每个用户QPS总限制 | 1秒10次 每个全站会员用户的QPS总限制 | 10000 (次) 每个用户每日请求总次数 |
接口地址:https://daoyouapi.com/api/dydj/index
返回格式:application/json
请求方式:HTTPGET
请求示例:https://daoyouapi.com/api/dydj/index?key=你的密钥&count=看文档&cursor=看文档&category=看文档
| 名称 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded;charset:utf-8; |
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| key | 是 | string | 35kj5jnlj53453kl5j43nj5 | 接口密钥,在控制台->密钥管理查看 |
| count | 否 | int | 20 | 获取短剧数量,取值范围1-50,默认20 |
| cursor | 否 | int | 0 | 分页游标,用于加载更多数据,默认0(首页) |
| category | 否 | string | 爱情 | 短剧分类筛选,支持:推荐、热榜、爱情、剧情、逆袭、反转、亲情、恩怨、玄幻、奇幻、古装、悬疑、友情、喜剧、犯罪、惊悚、青春、科幻、仙侠、其他,默认为推荐 |
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200表示成功 |
| msg | string | 状态信息 |
| data | array | 短剧列表数据集,包含短剧详细信息数组 |
| data[].mix_id | string | 短剧唯一标识ID |
| data[].mix_name | string | 短剧名称 |
| data[].desc | string | 短剧简介描述 |
| data[].cover | string | 短剧封面图片URL |
| data[].share_url | string | 短剧分享链接 |
| data[].status | object | 短剧状态信息(包含status状态码和status_msg状态描述) |
| data[].stats | object | 短剧统计数据(包含当前集数、更新至集数、总集数、收藏量、播放量) |
| data[].tags | array | 短剧标签数组 |
| debug | object | 调试数据(包含total总数、cursor游标、has_more是否有更多、category分类) |
| exec_time | float | 执行耗时(秒) |
| user_ip | string | 客户端IP地址 |
本服务仅供个人学习、学术研究目的使用,未经授权,请勿分享、传播输入及生成的文本、图片内容。用户在从事与本服务相关的一切行为(包括但不限于访问浏览、利用、转载、宣传介绍)时,应以善意且谨慎的态度行事并承担相应的风险和责任。用户需确保不得利用本服务进行危害国家安全和社会公共利益、扰乱经济秩序和社会秩序、侵犯他人合法权益等法律、行政法规禁止的活动,并且自定义输入文本不得包含违反法律法规、政治相关、侵犯他人合法权益的内容。对于用户因使用本服务而导致的任何损失或风险,包括但不限于由于使用本服务而产生的错误、疏忽、中断、删除、故障、延迟或通讯线路故障所导致的任何损失或损害,本服务的开发者将不承担任何责任。
{}
- "success": true,
- "message": "获取短剧列表成功",
-"data": [],
-{},
- "mix_id": "7575152387327363112",
- "mix_name": "纨绔皮下是阎罗",
- "desc": "皇帝为独女比武招亲,蛮夷欲夺魁。为阻蛮夷,皇帝命高手秦武测试青年。镇北侯之子苏羽表面纨绔,实为隐忍多年报母仇。测试中苏羽一拳重伤秦武,获得资格。比武场上,他再一拳败尽蛮夷,震惊四座,更引出其深藏的另一重惊人身份。",
- "cover": "https://p3-sign.douyinpic.com/tos-cn-i-dy/9cc07744a38088dc62f4e15682edad7d~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=8q6pBzjBRMXURWEits2xMVpZHsI%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7575152387327363112/?schema_type=43&object_id=7575152387327363112&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "77集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 77,
- "total_episode": 77,
- "collect_vv": 7,
- "play_vv": 847878242
-"tags": []
- "剧情"
-{},
- "mix_id": "7574008204864604195",
- "mix_name": "不好意思,我修仙的",
- "desc": "修真界无敌的庞天冲,为突破与寻亲下山进入都市。他以超凡实力轻松化解街头混混挑衅、豪门刁难、商业阴谋等难题,一路逆袭。在这个过程中,他结识了戴千雪,两人从冲突不断到互生情愫。同时,庞天冲在寻找亲生父母的道路上不断迈进,在都市中收获了爱情、友情,书写属于自己的传奇故事。",
- "cover": "https://p26-sign.douyinpic.com/tos-cn-i-dy/30a3214eb878a9c8a404032070bd86c8~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=b5G27zZWnTXdErXFiItNaVHECeo%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7574008204864604195/?schema_type=43&object_id=7574008204864604195&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "98集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 98,
- "total_episode": 98,
- "collect_vv": 7,
- "play_vv": 669664215
-"tags": []
- "恩怨斗争"
-{},
- "mix_id": "7574350968772970534",
- "mix_name": "绝地生还",
- "desc": "在东南亚A国,白手起家的首富江淮遭遇人生剧变,妻子沈知薇与兄弟陆骁合谋杀害其母,并嫁祸于他,导致江淮被判处无期徒刑,关入号称“十死无生”的魔鬼监狱。面对妹妹江瑶也将被迫害的绝境,江淮在狱中凭借超凡的智慧与坚韧,利用一把铁勺挖通牢墙,并成功盗取典狱长陆骁的手枪,最终在行刑前惊险越狱。逃出生天的江淮,在三位曾受其恩惠的势力首领帮助下,闯入仇敌的订婚宴会,与沈知薇、陆骁及其背后靠山方敬彬展开终极对决。",
- "cover": "https://p3-sign.douyinpic.com/tos-cn-i-dy/2c2856ee204049a37dd835479bbc4f20~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=StzgnPVgJwDPR0a4VtJDGdTM3jY%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7574350968772970534/?schema_type=43&object_id=7574350968772970534&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "63集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 63,
- "total_episode": 63,
- "collect_vv": 1,
- "play_vv": 458937689
-"tags": []
- "恩怨斗争"
-{},
- "mix_id": "7574807073037223951",
- "mix_name": "少夫人的乌鸦嘴又显灵了",
- "desc": "国际杀手组织女首领林荞正要金盆洗手,享受财富自由的人生,却穿入狗血小说,成为豪门总裁厉霆洲的炮灰舔狗老婆。林荞本想尽快离婚,走完剧情回到现实,没想到心声被厉霆洲听到,离婚计划泡汤。她只能一边扮演原主娇娇千金人设,一边用乌鸦嘴技能与厉霆洲斗智斗勇,没想到却将他撩到神魂颠倒!",
- "cover": "https://p11-sign.douyinpic.com/tos-cn-i-dy/1ff2fa04b64d343e02e5a5fcdacf37cc~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=ryLrNQKMg08lNm1TeiQ71Tlo2Ew%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7574807073037223951/?schema_type=43&object_id=7574807073037223951&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "80集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 80,
- "total_episode": 80,
- "collect_vv": 2,
- "play_vv": 396839660
-"tags": []
- "恩怨斗争"
-{},
- "mix_id": "7578139705079547904",
- "mix_name": "被校草撞飞后,男神倒追我",
- "desc": "贫困女大学生姜望星被校草顾辰撞飞后,竟意外获得了透视异能,自此她便从贫困生一跃成为了美女首富!在这过程中,校霸赌神李道勋,顾家太子爷顾辰,京海第一活阎王金少庭,三大男神纷纷被她吸引,这个女人真有意思!!",
- "cover": "https://p11-sign.douyinpic.com/tos-cn-i-dy/34841440f7ed0b6601a7f53e27a6633c~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=w6PuiIDXS%2FkCAGWcHjEtb4dlVb4%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7578139705079547904/?schema_type=43&object_id=7578139705079547904&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "79集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 79,
- "total_episode": 79,
- "collect_vv": 2,
- "play_vv": 466920312
-"tags": []
- "逆袭"
-{},
- "mix_id": "7568377498107381787",
- "mix_name": "初心不可违",
- "desc": "南城首富之女宋明月十年前因车祸流落山村,为报救命之恩,她以瘸腿之身嫁给林天意,并辛苦供养他读书。不料林天意进城后攀附宋家二小姐宋明珠,意图抛弃发妻。婆婆为保护宋明月被混混打死,宋明月一身孝服闯入婚礼现场,当众揭露林天意忘恩负义的真面目。在身份对峙中,村民王春燕凭借捡到的玉佩冒认了宋家大小姐身份。她与林天意联手污蔑宋明月,导致宋明月遭受亲人羞辱,更在争执中被推倒流产,初心不可违",
- "cover": "https://p3-sign.douyinpic.com/tos-cn-i-dy/68218b050f231c2025350147c0bba0ac~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=5oMABoiS4sowFjyDxx6LyCzgacQ%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7568377498107381787/?schema_type=43&object_id=7568377498107381787&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "62集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 62,
- "total_episode": 62,
- "collect_vv": 2,
- "play_vv": 532543206
-"tags": []
- "恩怨斗争"
-{},
- "mix_id": "7581665379895511081",
- "mix_name": "朝阳似我",
- "desc": "阮朝阳转正日遭裁员,意外邂逅程淮舟,人生轨迹就此改写。经他推荐,阮朝阳拿下顶尖咨询公司麦克斯韦的机会,凭借超强韧性站稳脚跟,从新人蜕变为独当一面的商业分析师。职场交锋中,她与程淮舟情愫渐生,走到一起。面对程淮舟完美外表下害怕爱、不懂表达爱的脆弱,阮朝阳用她的包容和乐观,耐心温柔地治愈程淮舟,一步步打开他紧闭的心扉。程淮舟开始尝试慢慢卸下那冰冷的外壳,学习松弛,学习接纳不完美的自己,学习如何表达爱。",
- "cover": "https://p26-sign.douyinpic.com/tos-cn-i-dy/f87373ab4d1285d0239656e031d70d0c~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=G8xI0zz%2FaX6Kh%2BFOySr3RDJOADY%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7581665379895511081/?schema_type=43&object_id=7581665379895511081&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "81集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 81,
- "total_episode": 81,
- "collect_vv": 0,
- "play_vv": 379966799
-"tags": []
- "爱情"
-{},
- "mix_id": "7581386099210094626",
- "mix_name": "退回18块8红包后,女儿破防了",
- "desc": "55岁的单亲妈妈方雅琴用退休金帮女儿还贷,带娃五年,却在生日当天被女儿当众发18块8元红包并嘲讽她贪财。心寒之下,她解绑工资卡,独自返乡。恰逢老城旧改,她依法获得安置补偿。失去依靠的女儿一家陷入经济困境,甚至谎称重病想让她出钱。方雅琴识破后,决定将财产全部捐给山区儿童公益项目。",
- "cover": "https://p11-sign.douyinpic.com/tos-cn-i-dy/84c48485b192640013e255fc1d7d8c81~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=u0N8gz9xGWzi3XJ7JPhpIMNoEm4%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7581386099210094626/?schema_type=43&object_id=7581386099210094626&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "49集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 49,
- "total_episode": 49,
- "collect_vv": 0,
- "play_vv": 377503277
-"tags": []
- "恩怨斗争"
-{},
- "mix_id": "7581774275934160948",
- "mix_name": "恋恋晚时光",
- "desc": "白玉婉发现丈夫孙振伟出轨初恋韩宝芹,并给两人买了墓地。愤而离婚。离婚后散心时邂逅万盛集团富豪赵知礼,他对她一见倾心,伪装相亲、悉心照料,展开追求。两人相爱遇双方子女反对,白玉婉以人格魅力赢得赵家认可,赵知礼的关爱感动白玉婉一双儿女。历经波折,两人终成眷属,50多岁也是追求幸福的好时机。",
- "cover": "https://p26-sign.douyinpic.com/tos-cn-i-dy/95b4ed1a5146f95a2b723980f4d6056a~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=B2f2L0ubClkX9dGP0eC2BKKQE%2B4%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7581774275934160948/?schema_type=43&object_id=7581774275934160948&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "70集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 70,
- "total_episode": 70,
- "collect_vv": 1,
- "play_vv": 443573147
-"tags": []
- "恩怨斗争"
-{},
- "mix_id": "7573598469470816262",
- "mix_name": "以身入局的她",
- "desc": "叶望舒功成名就后,为回报家乡资助建立养老院,却未料管理不善,致使老人遭受虐待,养老院沦为敛财工具。为查明真相,她化身护工暗访,亲眼目睹恶行,最终挺身而出解救老人,并顺藤摸瓜,揪出冒用集团名义横征暴敛的幕后黑手,令其受到法律严惩,还老人安宁晚年。",
- "cover": "https://p3-sign.douyinpic.com/tos-cn-i-dy/d66382fd1e382841bf87074c9744bb2f~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=w9OlBvPnj8x0RQhfQPfQfJ%2FidQQ%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7573598469470816262/?schema_type=43&object_id=7573598469470816262&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "72集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 72,
- "total_episode": 72,
- "collect_vv": 0,
- "play_vv": 420963282
-"tags": []
- "反转"
-{},
- "mix_id": "7577335088921217087",
- "mix_name": "利刃玫瑰第2部",
- "desc": "赌鬼父亲林大成债台高筑,竟押上一切作最后一搏!其女林小小为救父归来,身负惊世千术。牌桌之上,她一眼看穿三人设局,却将计就计,佯装入套。当对手自以为稳操胜券,布下“天局”绝杀时,林小小底牌惊现,手法逆转乾坤,反杀全场!这不仅是一场赌术的碾压,更是智谋与心态的终极较量,以此血淋淋的教训宣告,十赌十输,唯不赌方为赢家!",
- "cover": "https://p11-sign.douyinpic.com/tos-cn-i-dy/c0f65884315edcb3fac1e31fa114c213~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=0pcgQ6hBm1QVl5K%2FDBebhyM%2F7L4%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7577335088921217087/?schema_type=43&object_id=7577335088921217087&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "61集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 61,
- "total_episode": 61,
- "collect_vv": 0,
- "play_vv": 391290483
-"tags": []
- "反转"
-{}
- "mix_id": "7576513054297294875",
- "mix_name": "长公主蜀道山,皇帝连夜下诏罪己",
- "desc": "萧凤仪本是大乾长公主,亲领士卒打下江山,将弟弟萧麟煜扶上皇位后,带着女儿林浅浅归隐于乡野。十八年后,女儿出嫁,却发现好端端的状元女婿陆明远被皇帝赐婚给了丞相之女苏婉言,亲家母王素英还想逼自己的女儿入府做妾?她一怒之下带着女儿打回京城,誓要为女儿主持公道,把狗皇帝吊起来抽!",
- "cover": "https://p9-sign.douyinpic.com/tos-cn-i-dy/9d384878ebd9306792a1abc9d4d68c0f~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1766584800&x-signature=HZBcRjjzP84t271xpYnn9rDDXdw%3D&from=4080365293&s=PackSourceEnum_SERIES_FEED&se=false&sc=series_cover&biz_tag=aweme_series&l=202512222241591C57F503278AEFB8A41D",
- "share_url": "https://www.iesdouyin.com/share/playlet/detail/7576513054297294875/?schema_type=43&object_id=7576513054297294875&from_ssr=1",
-"status": {},
- "status": 2,
- "status_msg": "61集全"
-"stats": {},
- "current_episode": 0,
- "updated_to_episode": 61,
- "total_episode": 61,
- "collect_vv": 1,
- "play_vv": 304630319
-"tags": []
- "反转"
- "timestamp": 1766414519,
- "datetime": "2025-12-22 22:41:59",
- "total": 12,
- "cursor": 12,
- "has_more": true,
- "category": "推荐",
- "tip": "此接口由咔咔云独家开发,购买开源接口源码联系QQ:79087446",
- "copyright": "咔咔微信:kkjsz88"
| 错误码 | 类型 | 说明 |
|---|---|---|
| 403 | int | 没有权限 |
| 400 | int | 参数传递不正确 |
| 500 | int | 服务器内部错误 |
<?php
/**
* API请求DEMO
*
* 本demo支持常见的HTTP请求方法(GET/POST/PUT/DELETE等)
*/
//基本配置
$api_key = '你的接口密钥,登录控制台后在密钥管理页面申请';
$secret_key = '';
// API请求示例:
try {
$client = new ApiClient($api_key, $secret_key);
$client->setTimeout(10);
$client->setVerifySSL(false); // 关闭SSL验证
// GET请求示例
echo "=== 开始GET请求 ===\n";
$response = $client->get('https://daoyouapi.com/api/dydj/index', [
'key' => $api_key,
'key2' => '其他参数'
]);
print_r($response);
//print_r($client->getLastRequestInfo());
/*
// POST表单示例
echo "\n=== 开始POST请求 ===\n";
$response = $client->post('接口地址', [
'key' => $api_key,
'key2' => '其他参数'
]);
print_r($response);
print_r($client->getLastRequestInfo());
// POST JSON示例
echo "\n=== 开始POST JSON请求 ===\n";
$response = $client->postJson('接口地址', [
'key' => $api_key,
'key2' => '其他参数'
]);
print_r($response);
print_r($client->getLastRequestInfo());
*/
} catch (ApiClientException $e) {
echo "API请求错误: " . $e->getMessage();
if ($e->getCode() > 0) {
echo " (HTTP状态码: " . $e->getCode() . ")";
}
print_r($client->getLastRequestInfo() ?? []);
}
/**
* API客户端类
*
* 提供了一个简单的HTTP API客户端实现,支持常见的HTTP请求方法(GET/POST/PUT/DELETE等)
* 具有以下主要功能:
* - 支持 API 密钥和签名认证
* - 可配置请求超时和SSL验证
* - 支持自定义请求头
* - 支持表单和JSON格式的请求体
* - 自动解析响应结果
* - 提供详细的请求信息记录
*
* 使用示例:
* ```
* $client = new ApiClient('https://api.example.com', 'api_key', 'secret_key');
* $response = $client->get('/users', ['page' => 1]);
* ```
*
* @throws ApiClientException 当API请求失败时抛出异常
*/
class ApiClient
{
private $apiKey;
private $secretKey;
private $timeout = 30;
private $verifySSL = true;
private $lastRequestInfo = [];
private $defaultHeaders = [];
/**
* 构造函数
*
* @param string $apiKey API密钥(可选)
* @param string $secretKey 签名密钥(可选)
*/
public function __construct(string $apiKey = '', string $secretKey = '')
{
$this->apiKey = $apiKey;
$this->secretKey = $secretKey;
}
/**
* 设置请求超时时间(秒)
*/
public function setTimeout(int $seconds): self
{
$this->timeout = $seconds;
return $this;
}
/**
* 设置是否验证SSL证书
*/
public function setVerifySSL(bool $verify): self
{
$this->verifySSL = $verify;
return $this;
}
/**
* 添加默认请求头
*/
public function addDefaultHeader(string $name, string $value): self
{
$this->defaultHeaders[$name] = $value;
return $this;
}
/**
* 发送GET请求
*
* @param string $endpoint 接口端点
* @param array $query 查询参数
* @param array $headers 额外请求头
*/
public function get(string $endpoint, array $query = [], array $headers = []): array
{
return $this->request('GET', $endpoint, [
'query' => $query,
'headers' => $headers
]);
}
/**
* 发送POST请求(表单格式)
*
* @param string $endpoint 接口端点
* @param array $data POST数据
* @param array $headers 额外请求头
*/
public function post(string $endpoint, array $data = [], array $headers = []): array
{
return $this->request('POST', $endpoint, [
'form_data' => $data,
'headers' => $headers
]);
}
/**
* 发送POST请求(JSON格式)
*
* @param string $endpoint 接口端点
* @param array $data POST数据
* @param array $headers 额外请求头
*/
public function postJson(string $endpoint, array $data = [], array $headers = []): array
{
return $this->request('POST', $endpoint, [
'json' => $data,
'headers' => array_merge(['Content-Type' => 'application/json'], $headers)
]);
}
/**
* 发送PUT请求
*/
public function put(string $endpoint, array $data = [], array $headers = []): array
{
return $this->request('PUT', $endpoint, [
'json' => $data,
'headers' => $headers
]);
}
/**
* 发送DELETE请求
*/
public function delete(string $endpoint, array $data = [], array $headers = []): array
{
return $this->request('DELETE', $endpoint, [
'json' => $data,
'headers' => $headers
]);
}
/**
* 获取最后一次请求的详细信息
*/
public function getLastRequestInfo(): array
{
return $this->lastRequestInfo;
}
/**
* 基础请求方法
*/
private function request(string $method, string $endpoint, array $options = []): array
{
// 初始化cURL
$ch = curl_init();
$url = ltrim($endpoint, '/');
// 准备请求头
$headers = $this->prepareHeaders($options['headers'] ?? []);
// 处理查询参数
if (!empty($options['query'])) {
$url .= '?' . http_build_query($options['query']);
}
// 处理请求体
$postData = null;
if (isset($options['form_data'])) {
$postData = http_build_query($options['form_data']);
$headers[] = 'Content-Type: application/x-www-form-urlencoded';
} elseif (isset($options['json'])) {
$postData = json_encode($options['json']);
$headers[] = 'Content-Type: application/json';
}
// 设置cURL选项
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_TIMEOUT => $this->timeout,
CURLOPT_SSL_VERIFYPEER => $this->verifySSL,
CURLOPT_SSL_VERIFYHOST => $this->verifySSL,
CURLOPT_HEADER => true,
]);
if ($method !== 'GET' && $postData !== null) {
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
}
// 执行请求
$response = curl_exec($ch);
$error = curl_error($ch);
$info = $this->lastRequestInfo = curl_getinfo($ch);
curl_close($ch);
// 处理错误
if ($error) {
throw new ApiClientException("cURL请求失败: " . $error);
}
// 分离响应头和响应体
$headerSize = $info['header_size'];
$responseHeaders = substr($response, 0, $headerSize);
$responseBody = substr($response, $headerSize);
// 解析响应
$result = json_decode($responseBody, true) ?? $responseBody;
// 检查HTTP状态码
if ($info['http_code'] >= 400) {
$errorMsg = is_array($result) ? ($result['message'] ?? $responseBody) : $responseBody;
throw new ApiClientException("API请求失败: " . $errorMsg, $info['http_code']);
}
return [
'status' => $info['http_code'],
'headers' => $this->parseHeaders($responseHeaders),
'data' => $result
];
}
/**
* 准备请求头(自动添加签名)
*/
private function prepareHeaders(array $headers): array
{
// 合并默认头
$headers = array_merge($this->defaultHeaders, $headers);
// 添加签名头
if ($this->apiKey && $this->secretKey) {
$timestamp = time();
$signString = "key={$this->apiKey}×tamp={$timestamp}";
$signature = hash_hmac('sha256', $signString, $this->secretKey);
$headers['X-Api-Key'] = $this->apiKey;
$headers['X-Api-Timestamp'] = $timestamp;
$headers['X-Api-Sign'] = $signature;
}
// 转换为cURL格式
$curlHeaders = [];
foreach ($headers as $name => $value) {
$curlHeaders[] = "$name: $value";
}
return $curlHeaders;
}
/**
* 解析响应头
*/
private function parseHeaders(string $headers): array
{
$parsed = [];
foreach (explode("\r\n", $headers) as $i => $line) {
if ($i === 0) {
$parsed['HTTP_CODE'] = $line;
} else {
$parts = explode(': ', $line, 2);
if (count($parts) === 2) {
$parsed[$parts[0]] = $parts[1];
}
}
}
return $parsed;
}
}
class ApiClientException extends \Exception
{
// 自定义异常类
}
//jQuery-Ajax
$.ajax({
url: 'https://daoyouapi.com/api/dydj/index',
data: {
//接口参数,一行一个,可按照接口文档-请求参数 的参数填写,或者直接复制开发工具下面的测试代码。
key: '你的接口密钥,登录控制台后在密钥管理页面申请',
参数名: '参数值',
},
type: 'GET', //请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
dataType: 'json',
success: function(data) {
console.log(data); //请求成功,输出结果到控制台
},
timeout: 3000, //超时时间
error: function(data) {
console.log('请求失败'); //失败处理
}
});
| 子程序名 | 返回值类型 | 公开 | 备 注 | ||
| __启动窗口_创建完毕 | |||||
| 子程序名 | 返回值类型 | 公开 | 备 注 | ||
| Send_API | |||||
| 变量名 | 类 型 | 静态 | 数组 | 备 注 | ||
| REQU_Data | 文本型 | 提交字符串 | ||||
| return | 文本型 | 返回字符串 | ||||
| API_URL | 文本型 | 接口地址 | ||||
| API_KEY | 文本型 | 接口密钥 | ||||
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class Test {
public static void main(String[] args) {
try {
URL url = new URL("https://daoyouapi.com/api/dydj/index?key=你的接口密钥,登录控制台后在密钥管理页面申请");
HttpURLConnection connection = (HttpURLConnection)url.openConnection();
// 设置请求方式
connection.setRequestMethod("GET");
connection.connect();
// 获取响应码
int responseCode = connection.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String line;
while ((line = reader.readLine()) != null) {
// 读取到的内容给line变量
System.out.println(line);
}
reader.close();
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
// 发起一个GET请求
resp, err := http.Get("https://daoyouapi.com/api/dydj/index?key=你的接口密钥,登录控制台后在密钥管理页面申请")
if err != nil {
fmt.Println("http get error", err)
return
}
// 读取响应结果
result, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("http read error", err)
return
}
// 关闭响应结果
defer resp.Body.Close()
fmt.Println(string(result))
}
```
# 导入requests库
import requests
# 设置url
url = 'https://daoyouapi.com/api/dydj/index?key=你的接口密钥,登录控制台后在密钥管理页面申请'
# 发送post请求
response = requests.post(url, data={'key1': 'value1', 'key2': 'value2'})
# 获取响应内容
result = response.json()
# 打印结果
print(result)
```
// 以下是使用Node.js进行GET和POST请求API接口的示例代码:
const https = require('https');
const querystring = require('querystring');
// 定义请求选项
const options = {
hostname: 'daoyouapi.com',
path: '/api/dydj/index',
method: 'GET'
};
// 发送GET请求
https.get(options, res => {
console.log(`statusCode: ${res.statusCode}`);
res.on('data', d => {
process.stdout.write(d);
});
}).on('error', error => {
console.error(error);
});
// 发送POST请求
const postData = querystring.stringify({
'key1': 'value1',
'key2': 'value2'
});
const postOptions = {
hostname: 'daoyouapi.com',
path: '/api/dydj/index',
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
'Content-Length': Buffer.byteLength(postData)
}
};
const postReq = https.request(postOptions, res => {
console.log(`statusCode: ${res.statusCode}`);
res.on('data', d => {
process.stdout.write(d);
});
});
postReq.on('error', error => {
console.error(error);
});
postReq.write(postData);
postReq.end();
/*
这个示例代码使用Node.js内置的`https`模块进行HTTP请求。
首先定义了一个GET请求的选项,然后使用`https.get()`方法发送了GET请求。在响应流上注册回调函数,以便在收到响应数据时将其输出到控制台。在出现错误时,也注册了错误处理程序。
类似地,我们也定义了一个POST请求选项,并使用`https.request()`方法发送它。需要在请求头中包含适当的`Content-Type`和`Content-Length`以确保服务器可以正确解析请求体。请求体由`write()`方法写入,并在请求结束时通过调用`end()`方法通知请求对象已经完成。
注意,此示例默认使用`querystring`模块将数据作为x-www-form-urlencoded格式进行编码。如果需要使用其他格式(如JSON),则需要相应地更改请求头和请求体的编码方式。
另外,为了确保HTTPS请求的安全性,您也可以添加其他选项,例如验证服务器证书、设置代理等。
*/
以下是使用C语言进行GET和POST请求API接口的示例代码:
``` c
#include
#include
#include
#include // 需要安装curl库
// API地址
const char* url = "https://daoyouapi.com/api/dydj/index";
// GET请求
void getRequest(CURL* curl) {
CURLcode res;
// 设置URL
curl_easy_setopt(curl, CURLOPT_URL, url);
// 执行请求
res = curl_easy_perform(curl);
if(res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
}
// POST请求
void postRequest(CURL* curl) {
CURLcode res;
// 设置URL
curl_easy_setopt(curl, CURLOPT_URL, url);
// 设置POST数据
const char* postData = "key=你的接口密钥,登录控制台后在密钥管理页面申请&key1=value1";
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData);
// 执行请求
res = curl_easy_perform(curl);
if(res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
}
int main() {
CURL* curl;
CURLcode res;
// 初始化curl
curl = curl_easy_init();
if(curl) {
// 设置SSL验证
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L);
// GET请求
getRequest(curl);
// POST请求
postRequest(curl);
// 清理curl资源
curl_easy_cleanup(curl);
}
return 0;
}
```
这个示例代码使用了libcurl库进行HTTP请求。
首先,需要设置API地址。然后,基于`CURL`结构体创建curl句柄,并使用`curl_easy_setopt()`函数设置选项。这里设置了SSL验证,以确保请求的安全性。
在GET请求中,只需将URL设置为选项,然后调用`curl_easy_perform()`函数执行请求即可。
在POST请求中,还需要将POST数据作为字符串传递给`CURLOPT_POSTFIELDS`选项。
需要注意的是,为了避免内存泄漏,应该在使用完curl句柄之后调用`curl_easy_cleanup()`函数进行清理。
除了上述示例代码外,libcurl库还提供了更多高级选项,例如处理HTTP头、上传文件等。可以参考文档进行更详细的了解。
以下是一个使用C++请求API接口的示例代码:
```cpp
#include
#include
int main() {
CURL *curl;
CURLcode res;
std::string url = "https://daoyouapi.com/api/dydj/index?key=你的接口密钥,登录控制台后在密钥管理页面申请";
std::string response;
curl = curl_easy_init();
if (curl) {
curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, [](char *ptr, size_t size, size_t nmemb, void *userdata) -> size_t {
std::string *response = reinterpret_cast(userdata);
response->append(ptr, size * nmemb);
return size * nmemb;
});
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
res = curl_easy_perform(curl);
if (res == CURLE_OK) {
std::cout << "Response: " << response << std::endl;
} else {
std::cerr << "Error: " << curl_easy_strerror(res) << std::endl;
}
curl_easy_cleanup(curl);
}
return 0;
}
```
解释:
1. 引入需要的头文件:``用于输出结果,``用于使用libcurl库。
2. 定义需要请求的API接口的URL和存储响应数据的字符串变量。
3. 初始化一个CURL对象。
4. 设置CURL对象的参数:请求的URL(`CURLOPT_URL`)、是否跟随重定向(`CURLOPT_FOLLOWLOCATION`)、响应数据的写入函数(`CURLOPT_WRITEFUNCTION`)和响应数据的写入位置(`CURLOPT_WRITEDATA`)。
5. 发送HTTP请求并获取响应数据,判断返回状态码是否OK。
6. 清理CURL对象。
运行该程序会发送GET请求到指定的API接口URL,并在程序终止前将响应数据输出到终端。注意,在使用该示例代码之前需要安装libcurl库。
以下是一个使用C#请求API接口的示例代码:
```csharp
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program {
static async Task Main(string[] args) {
HttpClient client = new HttpClient();
string url = "https://daoyouapi.com/api/dydj/index?key=你的接口密钥,登录控制台后在密钥管理页面申请";
HttpResponseMessage response = await client.GetAsync(url);
if (response.IsSuccessStatusCode) {
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine("Response: " + responseBody);
} else {
Console.WriteLine("Error: " + response.StatusCode);
}
}
}
```
解释:
1. 引用需要的命名空间:`System.Net.Http`用于使用HttpClient类,`System.Threading.Tasks`用于异步执行请求操作。
2. 创建一个HttpClient对象。
3. 定义需要请求的API接口的URL。
4. 发送GET请求到指定的API接口URL,并获取响应结果。
5. 判断响应状态是否成功,如果成功则读取响应数据(使用ReadAsStringAsync方法),否则输出错误信息(使用StatusCode属性)。
运行该程序会发送GET请求到指定的API接口URL,并在程序终止前将响应数据输出到终端。注意,在使用该示例代码之前需要安装.NET Framework或.NET Core SDK。
以下是VB请求API接口的示例代码:
```
' 1. 引入Microsoft XML v6.0库
' 2. 创建一个XMLHTTP对象
Dim xhr As XMLHTTP
Set xhr = New XMLHTTP
' 3. 设置请求的URL、方法,以及是否异步等
xhr.Open "GET", "https://daoyouapi.com/api/dydj/index?key=你的接口密钥,登录控制台后在密钥管理页面申请", False
' 4. 发送请求
xhr.send
' 5. 获取响应结果
Dim responseText As String
responseText = xhr.responseText
' 6. 输出响应结果
Debug.Print responseText
' 7. 释放资源
Set xhr = Nothing
```
在这个示例中,我们创建了一个XMLHTTP对象,用于请求API接口。我们先调用`open`方法来设置请求的URL、方法,以及是否异步。然后,我们发送请求,并使用`responseText`属性来获取响应结果。最后,我们将响应结果打印到控制台,完成操作后释放资源,以防止内存泄漏。请注意,以上示例代码为同步请求,如果想使用异步请求,需要设置第三个参数为`True`,并在请求结束时处理`OnReadyStateChange`事件。
| 参数名 | 填写参数值 |
|---|---|
请 登录 后发表评论
填写业务相关参数免费在线调试
生成符合你的开发语言代码,复制即可
调整你后端部分逻辑代码即可上线使用