# 上架商品

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/open/product/publish:
    post:
      summary: 上架商品
      deprecated: false
      description: |-
        特别提醒：
        本接口会采用异步的方式更新商品信息到闲鱼 App 上，因此更新结果采用回调的方式进行通知。
      tags:
        - 商品
      parameters:
        - name: appid
          in: query
          description: ''
          required: true
          example: '{{appid}}'
          schema:
            type: string
        - name: timestamp
          in: query
          description: 当前时间戳（单位秒，5分钟内有效）
          required: false
          example: '{{timestamp}}'
          schema:
            type: integer
            default: '{{timestamp}}'
        - name: seller_id
          in: query
          description: 商家ID（仅商务对接传入，自研/第三方ERP对接忽略即可）
          example: '{{seller_id}}'
          schema:
            type: integer
        - name: sign
          in: query
          description: 签名MD5值（参考签名说明）
          required: true
          example: '{{sign}}'
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                product_id:
                  type: integer
                  title: 管家商品ID
                  examples:
                    - 219530767978565
                user_name:
                  type: array
                  items:
                    type: string
                    examples:
                      - tb924343042
                  title: 闲鱼会员名
                  minItems: 1
                  maxItems: 1
                  description: 指上架商品到哪个闲鱼店铺
                specify_publish_time:
                  type: string
                  title: 定时上架时间
                  examples:
                    - '2023-07-21 00:00:00'
                  description: 最小时间维度为分钟，并且以实际上架成功为准
                notify_url:
                  type: string
                  title: 商品回调通知地址
                  description: 回调参数请查看推送目录下的【商品回调通知】文档，会推送上架结果。
              required:
                - product_id
                - user_name
              x-apifox-orders:
                - product_id
                - user_name
                - specify_publish_time
                - notify_url
              x-apifox-ignore-properties: []
            example:
              product_id: 220656347074629
              user_name:
                - tb924343042
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/response_ok'
              examples:
                '1':
                  summary: 成功示例
                  value:
                    code: 0
                    msg: OK
                    data: {}
                '2':
                  summary: 异常示例
                  value:
                    code: 500
                    msg: Internal Server Error
          headers: {}
          x-apifox-name: 成功
        x-200:失败:
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    format: int32
                    examples:
                      - 500
                    additionalProperties: false
                  msg:
                    type: string
                    examples:
                      - Internal Server Error
                    additionalProperties: false
                required:
                  - code
                  - msg
                x-apifox-orders:
                  - code
                  - msg
                x-apifox-ignore-properties: []
          headers: {}
          x-apifox-name: 失败
      security: []
      x-apifox-folder: 商品
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/2973339/apis/api-95038267-run
components:
  schemas:
    response_ok:
      type: object
      properties:
        code:
          type: integer
          format: int32
          additionalProperties: false
          default: 0
        msg:
          type: string
          additionalProperties: false
          default: OK
        data:
          type: object
          properties: {}
          x-apifox-orders: []
          additionalProperties: false
          x-apifox-ignore-properties: []
      x-apifox-orders:
        - code
        - msg
        - data
      required:
        - code
        - msg
        - data
      title: 成功报文
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes:
    apiKey:
      type: apikey
      description: Enter JWT Bearer token **_only_**
      name: Authorization
      in: header
servers:
  - url: https://open.goofish.pro
    description: 新版正式环境
security: []

```