抖音一键获取商品详情信息，API开放接口指南

用户17779020068
4 阅读4分钟

以下是抖音一键获取商品详情信息的API开放接口指南，包含接口申请、调用流程、参数说明及注意事项等内容：

一、接口申请与权限获取

  1. 注册开发者账号：

    • 访问抖音开放平台官网，使用抖音账号或头条号注册开发者账号。
    • 建议使用企业邮箱注册，便于后续认证和维护。

  2. 完善开发者信息：

    • 登录后，进入【开发者中心】->【账户信息】。
    • 填写开发者类型（个人/企业）、提交营业执照（企业用户）、联系人信息，并进行邮箱验证。

  3. 创建应用：

    • 在【我的应用】->【创建新应用】。
    • 填写应用名称（必须唯一）、应用描述、回调地址（OAuth授权回调地址）、授权域名（网页授权域名）、应用图标（建议上传清晰Logo）。

  4. 申请接口权限：

    • 根据业务需求，选择需要申请的接口权限，如商品相关接口（item/onsale/get）、订单相关接口（order/list/query）等。
    • 提交申请后，等待抖音开放平台审核。

二、接口调用流程

  1. 获取Access Token：

    • 引导抖店商家完成应用授权，获取Access Token。这是调用接口的重要凭证。
    • Access Token通常有一定的有效期，需要定期刷新。

  2. 构建HTTP请求：

    • 根据API文档，构建HTTP请求，包括必要的参数如商品ID、Access Token等。
    • 请求方式通常为GET或POST，具体取决于接口设计。
    • 请求地址和参数需严格按照API文档要求填写。

  3. 发送请求并解析响应：

    • 使用HTTP客户端（如CURL、Postman或编程语言中的HTTP库）发送构建好的API请求。
    • 解析API返回的JSON响应数据，提取商品的详细信息。

三、接口参数说明

以查询商品详情接口为例，常见参数包括：

  1. 公共请求参数：

    • method：固定为查询商品详情的接口名称，如product.detail。
    • app_key：应用分配的AppKey。
    • access_token：店铺授权后获取的Access Token。
    • param_json：业务参数JSON字符串，包含商品ID等关键信息。
    • timestamp：时间戳（yyyy-MM-dd HH:mm:ss）。
    • v：协议版本，固定为2。
    • sign：参数签名（HMAC-SHA256或其他指定算法）。

  2. 业务参数（param_json） ：

    • product_id：抖店商品ID（19位），与out_product_id二选一。
    • out_product_id：外部商家自定义编码，与product_id二选一。
    • show_draft：是否读取草稿（true/false，默认false）。

四、接口返回字段说明

接口返回的数据通常为JSON格式，包含商品的详细信息。常见返回字段包括：

  1. 基础信息：

    • product_id：商品ID。
    • name：商品标题。
    • description：商品详情HTML。
    • pic：商品主图列表。
    • status：商品上下架状态。
    • check_status：商品审核状态。

  2. 价格信息：

    • market_price：划线价（单位：分）。
    • discount_price：售价（单位：分）。
    • spec_prices：SKU价格列表。

  3. 规格信息：

    • specs：规格项列表。
    • spec_prices：SKU详情列表，包含规格组合和对应价格、库存等信息。

  4. 销售信息：

    • sell_num：商品销量。
    • presell_type：预售类型。
    • delivery_method：发货时效。

  5. 其他信息：

    • category_detail：商品类目信息。
    • logistics_info：物流信息。
    • after_sale_service：售后服务信息。

五、注意事项与常见问题

  1. 参数合法性：

    • 确保商品ID等参数格式正确，避免非法参数导致的请求失败。
    • 常见错误码如40004表示参数非法（商品ID不存在或格式错误）。

  2. 权限与限流：

    • 确保应用具备调用接口的权限，避免权限不足导致的请求失败。
    • 接口有调用频率限制，需合理控制并发请求数，避免限流导致的请求失败。常见错误码如50002表示业务失败（限流、权限不足）。

  3. 数据安全与合规性：

    • 保护Access Token和AppSecret等敏感信息，避免泄露导致未授权访问。
    • 确保获取的数据用于合法目的，遵守相关法律法规和抖音开放平台的规定。

  4. 错误处理与重试机制：

    • 妥善处理API调用过程中可能出现的错误，如网络异常、接口返回错误等。
    • 对于可重试的错误（如系统异常），可实现重试机制提高请求成功率。常见错误码如20000表示系统异常，可稍后重试。

  5. 数据解析与格式转换：

    • 注意价格单位为分，详情为HTML格式，主图最多5张等特殊格式要求。
    • 根据业务需求对返回数据进行解析和格式转换，如将价格从分转换为元、提取HTML中的关键信息等。
avatar
文章
阅读
粉丝