京东ai图像搜索接口不支持php原生直连调用，因需手动实现严格签名算法（参数ascii升序拼接+app_key+timestamp+hmac-sha256+大写十六进制）、utc时间校准、base64预处理及json格式请求体，任一环节偏差即返回401或sign invalid。
京东AI图像搜索接口不支持PHP原生直连调用
京东AI开放平台的图像搜索（以图搜同款）接口，本质是 HTTPS POST 请求，需携带 access_token、image_url 或 base64 图片数据，以及签名（sign）。PHP 能发请求，但「能发」不等于「能直接调用」——关键卡在签名生成逻辑和认证流程上。官方只提供 Java/Python/Go 的 SDK 示例，PHP 无官方 SDK，所有签名、时间戳、参数排序、HMAC-SHA256 计算都得自己手写，且稍有偏差就返回 401 Unauthorized 或 sign invalid。
必须手动实现京东签名算法（不是简单拼接参数）
京东要求对请求参数做严格签名：按参数名 ASCII 升序排序，拼成 key1=value1&key2=value2 字符串，再拼上 app_key=xxx 和 timestamp=xxx（精确到秒），最后用 app_secret 做 HMAC-SHA256 签名，并转大写十六进制。漏掉空格、大小写、URL 编码、时间戳偏移都会失败。
-
timestamp必须与京东服务器时间误差 ≤ 5 分钟，建议用date('Y-m-d\TH:i:s\Z')+ UTC 时间校准 - 图片若传
image_url，URL 必须公网可访问、支持 CORS、且不能带中文或特殊符号（否则要urlencode()） - 若传 base64，必须去掉
data:image/jpeg;base64,前缀，只留纯 base64 字符串，且长度不能超 10MB（京东限制） - 签名原文中所有 value 都要先做
rawurlencode()，不是urlencode()
cURL 发起请求时容易忽略的 header 和 body 格式
京东接口要求 Content-Type: application/json，但 body 必须是标准 JSON 对象，不能是 form-data 或 query string。常见错误是把图片 base64 直接当字符串塞进 JSON，结果因换行/等号被截断；或忘了加 Accept: application/json 导致返回 HTML 错误页。
- 务必用
json_encode()构造 body，不要手动拼 JSON 字符串 - base64 字符串里若有换行符（\n），必须提前
str_replace(["\r", "\n"], '', $base64) - cURL 必须显式设置
CURLOPT_SSL_VERIFYPEER => false（仅测试环境），生产环境需配京东 CA 证书 - 响应状态码为 200 不代表成功，要检查 JSON 里的
code字段是否为0，message是否为"success"
调试阶段最常遇到的三个错误码
比看文档更快定位问题的方式，是盯住返回的 code 和 message：
-
code=1001：签名错误 —— 检查app_secret是否写错、参数排序是否漏了app_key或timestamp、HMAC 输出是否转大写 -
code=2002：图片格式不支持 —— 京东只认jpg、jpeg、png，且宽高 ≥ 100px，不能是 GIF 或 WebP -
code=4001：access_token 过期或无效 ——access_token有效期 2 小时，需单独调用鉴权接口刷新，不能复用登录态 token
真正难的不是发请求，而是让签名和京东服务器端完全对齐。哪怕一个空格位置不对，或者时间戳差了 1 秒，它就安静地返回 sign invalid，不告诉你哪错了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
