1. data_research资源转存
数据系统项目
  • dim层接口
  • dwd层接口
  • dws层接口
  • cfg数据表
  • ads层接口
  • 基础数据接口(品牌,企业,地区,分类)
    • 获取品牌列表-简易版
      GET
    • 获取品牌列表
      GET
    • 获取品牌列表-匹配多个名称
      POST
    • 获取品牌详情
      GET
    • 获取品牌列表(均分返回品牌和供应商信息)
      GET
    • 获取企业详情数据(全匹配名称)
      GET
    • 获取rel_brand_company
      GET
    • 获取地区信息 - 查询
      GET
    • 获取地区信息 - 非查询
      GET
    • 获取品牌的所有品类
      GET
    • 获取企业list
      GET
    • 获取企业详情数据
      GET
    • 新增企业
      POST
    • 新增企业(批量)
      POST
    • 更新企业
      PUT
    • 新增品牌信息
      POST
    • 更新品牌信息
      PUT
    • 品牌状态更新
      PUT
    • 企业状态更新
      PUT
    • 新旧品牌关系
      GET
    • 模糊匹配名称
      GET
  • ext接口
    • 品牌别名列表接口
    • 新增品牌别名
    • 地址解析省市接口
  • 大数据接口
    • PC端接口
    • 小程序接口
      • 品牌分类
      • 新增企业
      • 首页红餐指数
      • 首页热门品牌
      • 品牌库
      • 品牌列表 - 品牌搜索
      • 品牌列表 - 品牌搜索(剔除指定的二级品类)
      • 品牌页详细数据
      • 品牌在各省的门店数据
      • 品牌门店列表数据
      • 品牌在该省各城市的门店统计数据
      • 地区信息-查询
      • 地区信息-非查询
      • 供应商-推荐
      • 供应商-详情
      • 供应商列表 - 供应商搜索
      • 记录品牌点击量
      • 记录分类点击量
      • 品类搜索
      • 品类分析数据
      • 省市分析数据
      • 品类分析-首页接口 V2
      • 省市分析 - 首页接口 V2
      • 品类分析-首页接口
      • 省市分析 - 首页接口
      • 供应商产品列表页
      • 供应商合作伙伴
      • 红餐大数据供应商合作品牌
      • 产品与菜单详情
      • 品牌开关店时序图/品牌拓店里程碑
      • 品牌开关店列表
      • 融资时间线
      • 品类-品牌新开门店列表
      • 获取高德行政区域列表
      • 获取高德行政区域树形结构信息
      • 品牌详情页-选址类型占比
    • 大屏接口(旧版)
      • 全国餐饮品类分布占比
      • 全国在营门店/品牌/新开门店
      • 全国地图省份门店/品牌数
      • 餐饮门店数省份TopN
      • 餐饮入驻品牌省份TopN
      • 最新月份全国新开门店品类列表
      • 全国餐饮品牌门店数TopN
      • 全国餐饮收入
      • 最新月份全国新开门店品牌TopN
    • 大屏接口(新版)
      • 全国在营门店/品牌/新开门店
      • 全国地图省份门店/品牌数
      • 餐饮门店数省份TopN
      • 餐饮入驻品牌省份TopN
    • 数据提取需求接口
      • dim层接口
        • 分类维表
        • 品牌维表
        • 省份维度
        • 城市维度
        • 区域维表
        • 城市等级维表
        • 企业维表
        • 人均价格区间维表
        • 品牌门店数量区间维表
      • dwd层接口
        • 供应商产品
        • dwd_hcc_award
        • dwd_hcc_award_ranking
        • dwd_hcc_award_type
        • dwd_hcc_award_winner
        • 品牌推荐菜历史记录
      • dws层接口
        • 品牌门店统计
        • 品牌省份门店统计
        • 品类全国统计 Copy
        • 品类省份统计 Copy
        • 品类城市统计 Copy
      • ads层接口
        • 品牌门店统计
        • 品牌省份门店统计
        • 品类全国统计
        • 品类省份统计
        • 品类城市统计
        • 品类城市等级统计
        • 品类人均价格分布
        • 品类品牌门店数量区间
        • 市场规模
        • 市场容量
        • 竞争环境
        • 标杆品牌 Top10
        • 消费星期分布
        • 消费时间段
        • 消费人群 Top10
        • 客群特征
        • 门店数区间
        • 品牌消费趋势
      • ext扩展层接口
        • 品牌/供应商联系人扩展表
      • rel关系层接口
        • 供应商-品牌关系表
    • 省市分析v6.66(新版)
      • 统计接口
        • 省市市场总览
        • 门店消费价格分布
        • 固定标杆品牌
        • 品牌门店排名
        • Top100 一级品类汇总
      • 维度接口(可选)
        • 城市维度
        • 城市等级维度
        • 一级餐饮品类维度
        • 品牌维度
    • 省市分析v6.70(新版)
      • 省市市场总览(v6.66接口扩展)
      • 门店消费价格分布(v6.66接口扩展)
      • 固定标杆品牌(v6.66接口扩展)
      • 品牌门店排名(v6.66接口扩展)
      • 年度画像当前值(v6.70新接口)
      • 年度画像历史值(v6.70新接口)
      • 全国 Top200 一级品类汇总(v6.70新接口)
      • 区域地理标志产品(v6.70新接口)
      • 餐饮市场分布(v6.70新接口)
    • V6.83供应商升级
      • 供应商搜索、列表(新增)
      • 供应商详情
      • 品牌采用供应商
      • 供应商搜索、列表(旧接口)
    • V6.85供应商产品详情
      • 供应商分类列表及供应商数量(新增接口)
      • 供应商地区列表及供应商数量(新增接口)
      • 供应商搜索、列表(新增接口)
      • 供应商详情(迭代改造)
      • 供应商产品列表(迭代改造)
      • 供应商产品详情(新增接口)
    • V1.51主数据管理接口
      • 品牌上下架
      • 品牌列表
      • 品牌详情
      • 品牌建档
      • 品牌增量更新
      • 供应商列表
      • 供应商详情
      • 供应商建档
      • 供应商增量更新
      • 供应商上下架
      • 主数据修改历史
    • data_research资源转存
      • 外部图片视频转存COS
        POST
  • 拓展接口
    • 新旧品牌ID映射关系-prod
  • prod-线上数据
    • 品类-品牌新开门店列表-prod
    • 供应商-详情-prod
    • 供应商-推荐-prod
    • 获取品牌详情 -prod
    • 地区信息-查询-prod
    • 获取企业详情数据-prod
    • 新旧品牌关系-prod
    • 获取品牌列表_prod
    • 品牌开关店时序图/品牌拓店里程碑-prod
    • 品牌开关店列表 prod
    • 最新月份全国新开门店品类列表_prod
  • redis-数据
    • redis-队列数据
  • 数据模型
    • cfg_award_category
    • ErrorResponse
    • cfg_platform_account
    • Category
    • cfg_res_category
    • SupplierCard
    • cfg_res_category_wd
    • QueryResponse
    • cfg_tag
    • RegionsResponse
    • dim_brand
    • ProductDetailResponse
    • dim_category
    • LegacyProduct
    • dim_city
    • ProductsResponse
    • dim_city_level
    • SupplierBase
    • dim_company
    • SupplierCompany
    • dim_country
    • SupplierDetailResponse
    • dim_date
    • dim_district
    • dim_dp_area
    • dim_dp_category
    • dim_food_category
    • dim_gd_area
    • dim_gd_category
    • dim_province
    • dim_region
    • rel_brand_category
    • rel_brand_company
    • rel_brand_suppplier
    • rel_store_category
    • ext_dim_area_alias
    • ext_dim_brand_alias
    • ext_dim_brand_contact
    • ext_dim_brand_scale
    • cfg_platform
  1. data_research资源转存

外部图片视频转存COS

开发中
POST
/api/data_research/cos_transfer

用途#

把业务系统提供的外部图片/视频链接同步下载并转存到腾讯云 COS,返回我方可长期访问的链接。接口不落数据库,只返回链接。

限制#

项取值
单文件大小上限100MB
支持格式JPEG、PNG、GIF、WEBP、MP4、MOV;按文件魔数判定,不信任源站 Content-Type
协议仅 http、https
端口白名单80、443、8080、8443
重定向最多 3 跳,每一跳重新校验协议、端口与内网地址
下载时间预算18 秒
整体时间预算25 秒;调用方 nginx 超时 30 秒
安全拦截拒绝内网、回环、链路本地、保留、组播地址与云元数据地址;拒绝 URL 携带账号密码

对象 Key 规则#

data_research/resources/{yyyyMM}/{md5(源URL)}-{md5(文件内容)前8位}.{扩展名}
同一 URL 且内容未变化时覆盖自身,等价幂等;源站内容变化时生成新对象,此前返回给调用方的链接不会失效。对象写入时设置为 public-read,返回链接可匿名直接访问。

返回链接域名#

返回的 cos_url 使用 CDN 加速域名,取配置 TENCENT_COS.cdn_url 拼接对象 Key(本地 https://data-dev-res.canyin88.com,线上 https://static-dt.canyin88.com);该配置缺失时自动回退 COS 原生域名 base_url。上传仍走 COS 原生域名,只有返回给调用方的链接改用 CDN,因此 CDN 必须已配置回源到当前桶,否则链接不可访问。

错误码#

业务码含义
0转存成功
1001resource_url 缺失、类型或长度不合法
1014源站不可达、返回非 2xx、重定向异常或内容为空
1015下载或转存超出时间预算
1016文件体积超过 100MB
1017文件格式不在图片/视频白名单内
1018写入 COS 失败
1019URL 非法或命中内网地址拦截
注:项目统一响应包装会把业务码大于等于 500 的错误映射为 HTTP 500,网关若对 5xx 自动重试需评估。

请求参数

Body 参数application/json必填

示例
{
    "resourceUrl": "https://cdn.example.com/material/demo.mp4"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/data_research/cos_transfer' \
--header 'Content-Type: application/json' \
--data '{
    "resourceUrl": "https://cdn.example.com/material/demo.mp4"
}'

返回响应

🟢200转存成功
application/json
业务码 0,data 返回 CDN 资源链接与文件元信息。
Bodyapplication/json

示例
{
    "code": 0,
    "message": "string",
    "data": {
        "cos_url": "string",
        "object_key": "string",
        "size": 0,
        "content_type": "string",
        "elapsed_seconds": 0
    }
}
🔴500参数缺失或非法(1001)
🔴500源站访问失败(1014)
🔴500转存超时(1015)
🔴500体积超限(1016)
🔴500格式不支持(1017)
🔴500写入COS失败(1018)
🔴500URL非法或内网拦截(1019)
修改于 2026-11-13 06:14:53
上一页
主数据修改历史
下一页
新旧品牌ID映射关系-prod
Built with