,包含特效信息数组,每个特效对象包含以下字段:展开代码语言:JSONAI代码解释[{"effect_title":"录制边框III",//特效名称/标题,必选参数"start":0,//特效开始时间(微秒...),必选参数"end":5000000//特效结束时间(微秒),必选参数}]字段说明:effect_title:特效名称,必须是系统中已存在的特效名称start:特效开始时间,单位为微秒,必须大于等于0end...(4xx/5xx)展开代码语言:JSONAI代码解释{"detail":"错误信息描述"}使用示例cURL示例1.基本特效添加展开代码语言:BashAI代码解释curl-XPOSThttps://capcut-mate.jcaigc.cn...400draft_url是必填项缺少草稿URL参数提供有效的draft_url400effect_infos是必填项缺少特效信息参数提供有效的effect_infos400时间范围无效end必须大于start...确保结束时间大于开始时间400无效的特效信息,请检查effect_infos字段值是否正确特效参数校验失败检查特效参数是否符合要求404草稿不存在指定的草稿URL无效检查草稿URL是否正确404特效不存在指定的特效名称无效确认特效名称是否正确
请求参数参数名称类型必选描述api_tokenString是您的api_token,用于验证请求者身份。...填写错误将导致请求失败,报402错误。uploadedFileString是要上传的文件,缺少该参数报406错误。modeNumber(Int)、String否命名方式,可取值1,2,3。..., $post_data); $output = curl_exec($ch); curl_close($ch); // 打印调用结果 echo $output; // 以下代码只是调用结果展示...(在后台开启即可)402失败:api_token错误。(请查证api_token)403失败:文件尺寸超限。(升级套餐或调整文件尺寸)405失败:未被支持的扩展名(文件格式)。...500失败:其他错误或服务器内部错误。(请联系客服处理)
ADD_STICKERAPI接口文档接口信息展开代码语言:TXTAI代码解释POST/openapi/capcut-mate/v1/add_sticker功能描述向现有草稿中添加贴纸。...(4xx/5xx)展开代码语言:JSONAI代码解释{"detail":"错误信息描述"}使用示例cURL示例1.基本贴纸添加展开代码语言:BashAI代码解释curl-XPOSThttps://capcut-mate.jcaigc.cn...400draft_url是必填项缺少草稿URL参数提供有效的draft_url400sticker_id是必填项缺少贴纸ID参数提供有效的sticker_id400start是必填项缺少开始时间参数提供有效的...start时间400end是必填项缺少结束时间参数提供有效的end时间400时间范围无效end必须大于start确保结束时间大于开始时间400缩放比例无效scale超出建议范围使用0.1-5.0范围内的缩放值...400无效的贴纸信息,请检查贴纸参数是否正确贴纸参数校验失败检查贴纸参数是否符合要求404草稿不存在指定的草稿URL无效检查草稿URL是否正确404贴纸不存在指定的贴纸ID无效确认贴纸ID是否正确500
【请求地址】:【GET】 https://api.weixin.qq.com/sns/jscode2session 【请求参数 】 参数名必选类型说明appid是string小程序唯一凭证,即 AppID...-1、0、40029、 45011、 40226 (具体说明,请阅读 接口文档)errmsgstring错误信息 示例代码 【PHP 示例代码】 ( tip: 公共方法 do_curl_get_request...cgi-bin/token 【请求参数 】 参数名必选类型说明grant_type是string填写 "client_credential"appid是string小程序唯一凭证,即 AppID,可在...access_token=ACCESS_TOKEN 【请求参数 】 参数名必选类型说明access_token是string 接口调用凭证 scene是string场景信息,最大32个可见字符,只支持数字...用户在 PC 端请求显示 小程序码时,需要一个传一个参数 pc_code (可用时间戳+随机数) 2. 后台,curl 调用微信服务接口,获取小程序码,返回到 PC 端显示 3.
, false); curl_setopt($curl, CURLOPT_URL, $url); $res = curl_exec($curl); $errors = curl_error...($curl); \Log::info("wechat",['res'=>json_encode($res),'error'=>$errors]); curl_close($curl);...return $res; } } 前提 登录公众号 功能设置”里填写“JS接口安全域名” 不加 http, 一个月只能改3次,设置JS接口安全域名后,公众号开发者可在该域名下调用微信开放的...JS接口。...40164 错误信息:无效ip,不在白名单中 登录公众平台,开发->基本配置->IP白名单->查看->修改->将ip地址添加进去即可,多个ip换行添加。
,单次提交数量超过一万条被系统拦截;服务器时区不统一,时间戳差值超出±60秒触发校验报错;缺少唯一请求标识,网络抖动重试引发短信重复扣费下发;未做前置参数校验,大量无效请求挤占接口服务资源。...请求头部必须固定配置Content-Type:application/json,不支持GET方式传参调用,不符合该规范会直接返回请求参数异常。...签名大小写错误、参数漏填是对接失败的首要诱因。...发起接口POST调用curl_setopt($curl,CURLOPT_POST,true);curl_setopt($curl,CURLOPT_HTTPHEADER,["Content-Type:application...4.2海量号码群发专项优化清单提前对手机号进行去重、空号过滤,减少无效接口请求消耗;超万级号码采用分片异步拆分调用,分摊接口并发压力;本地程序完成全量参数预校验,拦截非法数据后再发起网络请求;对接回执推送服务
该接口用于保存当前的草稿状态,确保编辑的内容得到持久化存储。通常在完成一系列编辑操作后调用此接口,以防止编辑内容丢失。...draft_id=2025092811473036584258"}参数说明参数名类型必填默认值说明draft_urlstring✅-要保存的草稿URL参数详解draft_url类型:字符串必填:是格式:...:JSONAI代码解释{"detail":"错误信息描述"}使用示例cURL示例1.基本保存草稿展开代码语言:BashAI代码解释curl-XPOSThttps://capcut-mate.jcaigc.cn...draft_id=2025092811473036584258"}'错误码说明错误码错误信息说明解决方案400draft_url是必填项缺少草稿URL参数提供有效的draft_url400draft_url...格式无效URL格式不正确检查URL格式是否正确404草稿不存在指定的草稿无法找到确认草稿URL是否正确且存在500保存失败内部服务错误联系技术支持或稍后重试503服务不可用系统维护中稍后重试注意事项URL
ADD_IMAGESAPI接口文档接口信息展开代码语言:TXTAI代码解释POST/openapi/capcut-mate/v1/add_images功能描述向现有草稿中添加图片。...(4xx/5xx)展开代码语言:JSONAI代码解释{"detail":"错误信息描述"}使用示例cURL示例1.基本图片添加展开代码语言:BashAI代码解释curl-XPOSThttps://capcut-mate.jcaigc.cn...400draft_url是必填项缺少草稿URL参数提供有效的draft_url400image_infos是必填项缺少图片信息参数提供有效的image_infos400image_url是必填项图片URL...缺失为每个图片提供URL400图片尺寸无效width或height无效提供正数的宽度和高度400时间范围无效end必须大于start确保结束时间大于开始时间400透明度无效alpha超出建议范围使用0.0...-1.0范围内的透明度值404草稿不存在指定的草稿URL无效检查草稿URL是否正确404图片不存在指定的图片URL无效确认图片URL是否正确500图片添加失败内部处理错误联系技术支持注意事项时间单位:所有时间参数使用微秒
502 Bad Gateway错误表示作为网关或代理的服务器,从上游服务器(比如我们的应用服务器)收到了一个无效的响应。...情况一:信封上地址写得乱七八糟,邮递员看不懂(请求语法错误)。 情况二:你说要寄一个“五彩斑斓的黑”的包裹,邮递员表示无法理解这种物品(请求参数不合法或语义错误)。...参数无效或缺失: 请求中传递的参数不符合服务器端的校验规则(类型不对、长度超限、值不在允许范围内、必填参数未传)。 请求过大: 请求头或请求体的大小超过了服务器配置的限制。...curl 示例 (发送一个格式错误的JSON): # 错误的JSON: age应该是数字,但用了字符串;缺少逗号 curl -X POST -H "Content-Type: application...认证凭据无效: 提供的用户名/密码错误。 提供的API Token、JWT (JSON Web Token)、OAuth令牌等无效、已过期、或被吊销。
一、调用营销短信接口的核心痛点与技术背景1.1开发者常见对接难题多数开发者在初次对接营销短信API时,都会陷入三类问题:参数缺失/格式错误:必填参数遗漏、数据类型不匹配,直接触发接口报错;签名生成不规范...二、营销短信API核心原理与参数规范正确调用接口的前提,是掌握底层通信规则和参数要求,本节对核心机制进行拆解。...2.3必选/可选参数区分调用营销短信接口时,需严格区分参数类型,避免必填项缺失:必选参数:api_id、signature、timestamp、request_id、product_id、phone、sign_name...拒收请回复R'];//发起POST请求调用接口$ch=curl_init($config['api_url']);curl_setopt($ch,CURLOPT_HTTPHEADER,['Content-Type...>四、发送状态码解析与开发避坑技巧4.1核心状态码速查调用营销短信接口后,通过状态码可快速定位问题:OK:请求成功,短信进入发送队列;ParamError:参数缺失/格式错误;SignError:签名加密规则错误
在项目开发中,语音通知接口调用是实现订单提醒、验证码下发、系统告警的核心环节,但开发者常因参数错误、无重试逻辑、异常处理不足导致接口调用不稳定,甚至出现通知丢失的问题。...一、开发者调用语音通知接口的核心痛点语音通知接口调用的过程中,新手和资深开发者都会遇到各类问题,这些问题直接影响接口调用的稳定性:参数配置错误:如mobile格式不规范(未按11位手机号+掩码规范,如1398888...(手机号格式错误):确保mobile为11位手机号(如1398888)或规范固话格式;code=408(频率限制):优化调用频率,避免同一手机号1秒内多次调用;code=407(敏感字符):检查content...内容,替换敏感词汇并完成模板备案;code=5xx(服务器错误):触发重试逻辑,或联系接口提供商排查。...实现指数退避重试逻辑,仅对偶发错误(网络超时、5xx)重试,避免无效请求;全面解析状态码,针对不同code制定差异化处理策略,提升问题定位效率;规范参数格式(尤其是mobile),并记录完整调用日志(参数
ADD_KEYFRAMESAPI接口文档接口信息展开代码语言:TXTAI代码解释POST/openapi/capcut-mate/v1/add_keyframes功能描述向现有草稿中添加关键帧。...(4xx/5xx)展开代码语言:JSONAI代码解释{"detail":"错误信息描述"}使用示例cURL示例1.基本关键帧添加展开代码语言:BashAI代码解释curl-XPOSThttps://capcut-mate.jcaigc.cn...400draft_url是必填项缺少草稿URL参数提供有效的draft_url400keyframes是必填项缺少关键帧参数提供有效的keyframes数据400无效的关键帧信息,请检查keyframes...字段值是否正确关键帧数据格式错误检查关键帧数据格式是否符合要求404草稿不存在指定的草稿URL无效检查草稿URL是否正确404片段未找到指定的segment_id在草稿中不存在确认片段ID是否正确400...无效的片段类型该片段不支持关键帧功能确保为目标片段是视觉片段(视频、图片、贴纸、文本)400无效的关键帧属性类型指定的property类型不受支持检查属性类型是否在支持列表中500关键帧添加失败内部处理错误联系技术支持注意事项片段
GET_DRAFTAPI接口文档接口信息展开代码语言:TXTAI代码解释GET/openapi/capcut-mate/v1/get_draft功能描述获取草稿文件列表。...该接口用于获取指定草稿ID对应的所有文件列表,可以查看草稿中包含的素材文件、配置文件等信息。通常用于草稿内容的预览、文件管理或状态检查。...(4xx/5xx)展开代码语言:JSONAI代码解释{"detail":"错误信息描述"}使用示例cURL示例1.基本获取草稿文件列表展开代码语言:BashAI代码解释curl-XGET"https:/...是必填项缺少draft_id参数提供有效的draft_id400draft_id长度无效draft_id长度不在20-32位范围内检查draft_id格式是否正确400draft_id格式无效draft_id...格式不正确确保使用正确的草稿ID格式404草稿不存在指定的草稿ID无法找到确认草稿ID是否正确且存在500获取文件列表失败内部服务错误联系技术支持或稍后重试503服务不可用系统维护中稍后重试注意事项参数格式
本文将作为一份完整的开发文档,详细解读 个人信用分API 的调用流程、参数加密机制、数据结构与字段说明,协助开发者快速完成集成与业务应用。二、API接口调用示例1....每次调用都需携带有效的 Access-Id,并保证密钥安全。2. cURL 调用示例curl -X POST "https://api.tianyuanapi.com/api/v1/JRZQ0L85?...mobile_no手机号用户注册手机号id_card身份证号用户身份证号码name姓名用户真实姓名(2)响应参数说明字段名含义说明code状态码0 表示成功,其它为错误message返回信息接口调用返回的状态描述...;为-1时表示未命中(4)错误码说明codemessage说明0业务成功调用成功返回结果1000查询为空未查询到结果1001接口异常系统内部错误1002参数解密失败data参数解析错误1003基础参数校验不正确缺少必要字段或格式错误...1004未经授权的IP当前IP未加入白名单1005缺少Access-Id未传入认证头信息1006未经授权的AccessId认证ID无效1007账户余额不足需充值后继续使用1008未开通此产品未授权访问该
一般用于client是Web服务器端应用或第三方的原生App调用资源服务的时候。...错误响应 如果终端用户拒绝了访问请求,或者由于除了缺少或无效重定向URI之外的其它原因而导致请求失败, error_description 可选参数。...错误响应 如果终端用户拒绝了访问请求,或者由于除了缺少或无效重定向URI之外的其它原因而导致请求失败, error 错误码 invalid_request 请求缺少某个必需参数,包含一个不支持的参数或参数值...invalid_grant 提供的访问许可是无效的、过期的或已撤销的(例如,无效的断言,过期的授权令牌,错误的终端用户密码证书,或者不匹配的授权码和重定向URI)。...错误响应 如果终端用户拒绝了访问请求,或者由于除了缺少或无效重定向URI之外的其它原因而导致请求失败, error_description 可选参数。
=nil{iferrors.Is(err,gorm.ErrRecordNotFound){return"",nil,errors.New("用户名或密码错误")}return"",nil,fmt.Errorf...utils.CheckPassword(req.Password,user.Password){return"",nil,errors.New("用户名或密码错误")}//生成JWTtokentoken...=nil{fields["username"]=username}//记录错误信息iflen(c.Errors)>0{fields["errors"]=c.Errors.String()}//根据状态码选择日志级别...或Postman测试API:展开代码语言:BashAI代码解释#1.用户注册curl-XPOSThttp://localhost:8080/api/v1/auth/register\-H"Content-Type...Logrus进行结构化日志14.3最佳实践分层架构:Controller-Service-Repository模式依赖注入:通过构造函数注入依赖接口设计:定义清晰的接口边界错误处理:统一的错误处理机制安全性
数据上传后,一旦其他人请求查询此数据,用户将收到通知并可以授权或拒绝该请求 URL /v1/tee/ [POST] 请求参数 参数 必选 类型 说明 ciphertext ture string...因环境的不同,结果可能不一致,并不能说明调用失败。 curl -X GET "http://localhost:8060/v1/tee/?...因环境的不同,结果可能不一致,并不能说明调用失败。 curl -X GET "http://localhost:8060/v1/tee/request/?...查询您作为数据所有者收到的所有通知,并授权或拒绝请求 URL /v1/tee/notification/ [GET] 请求参数 参数 必选 类型 说明 owner true string...因环境的不同,结果可能不一致,并不能说明调用失败。 curl -X GET curl -X GET "http://localhost:8060/v1/tee/notification/?
ADD_MASKSAPI接口文档接口信息展开代码语言:TXTAI代码解释POST/openapi/capcut-mate/v1/add_masks功能描述向现有草稿中的指定片段添加遮罩效果。...(4xx/5xx)展开代码语言:JSONAI代码解释{"detail":"错误信息描述"}使用示例cURL示例1.基本遮罩添加展开代码语言:BashAI代码解释curl-XPOSThttps://capcut-mate.jcaigc.cn...400draft_url是必填项缺少草稿URL参数提供有效的draft_url400segment_ids是必填项缺少片段ID参数提供有效的segment_ids数组400无效的遮罩信息,请检查遮罩参数是否正确遮罩参数校验失败检查遮罩参数是否符合要求...400羽化程度无效feather超出范围使用0-100范围内的羽化值400旋转角度无效rotation超出范围使用0-360范围内的角度值400圆角半径无效roundCorner超出范围使用0-100范围内的圆角值...:支持线性、镜面、圆形、矩形、爱心、星形六种遮罩类型性能考虑:避免同时添加大量遮罩工作流程验证必填参数(draft_url,segment_ids)检查片段ID的有效性从缓存中获取草稿查找并验证遮罩类型为每个片段添加遮罩保存草稿返回遮罩信息相关接口创建草稿添加视频添加音频添加图片保存草稿生成视频项目资源
全局错误码 更新时间:2018/12/05 访问次数:129119 全局返回码说明 全局返回码说明 开发者每次调用接口时,可能获得正确或错误的返回码,企业可以根据返回码信息调试接口,排查错误。...参数是否为空 41007 无效的ssocode sso的永久授权code无效,检查下是否为空 41008 缺少oauth 无 41009 缺少UserID 检查下UserID是否为空 41010 缺少url...无 4200020 客户描述表单数据缺少固定字段 无 4200021 客户联系人描述表单数据格式校验错误 无 4200022 客户联系人描述表单数据缺少固定字段 无 800001 仅限ISV调用 只有...具体请参考当前接口的文档的参数说明和参数示例。 400003 时间戳无效 检查随机时间戳是否符合规格。具体请参考当前接口的文档的参数说明和参数示例。...400004 随机数无效 检查随机随机数是否符合规格。具体请参考当前接口的文档的参数说明和参数示例。
很多开发者在对接语音验证码接口时,常遇到前后端参数传递错误、签名验证失败、频率限制踩坑等问题。...网站语音验证码接口的调用成功与否,关键在于参数的准确性和安全机制的实现:必填参数:account(APIID)、password(APIKEY/动态密码)、mobile(用户手机号)是核心必填项,缺少任一参数都会返回...401/402/403等错误码;安全机制:动态密码通过MD5加密(account+password+mobile+content+time)生成,可有效防止参数被篡改;IP备案机制则能避免接口被非法调用...后端作为接口调用的核心层,需负责参数校验、签名生成、接口请求和结果处理。以下是完整的调用示例,包含动态密码生成和注册链接(用于获取APIID/APIKEY)的集成:展开代码语言:PHPAI代码解释参数校验:前后端双重校验手机号格式,后端校验所有必填参数,避免无效接口请求;异常重试:对接口返回的非频率限制类错误(如code=0),可设置1-2次重试机制,提升成功率;日志记录:记录每次接口调用的参数