공급업체 문의 조회

조회 엔드포인트는 세 개이며 모두 supplier_inquiry:read 스코프가 필요합니다. 문의는 이를 생성한 애플리케이션에 한정되므로, 다른 애플리케이션의 문의 ID를 조회하면 403이 아니라 404 INQUIRY_NOT_FOUND가 반환됩니다.

문의 목록 조회

GET /v1/supplier-inquiries

쿼리설명
status문의 상태 한 가지 (pending, processing, waiting_supplier, answered, completed, failed, cancelled)
channel1688 또는 taobao
source_product_id마켓플레이스 상품 ID 정확히 일치
created_after / created_beforeISO 8601 타임스탬프
page기본값 1
limit기본값 20, 최대 100
GET /v1/supplier-inquiries?status=answered&channel=1688&limit=20
 
{
  "data": [
    {
      "id": "sinq_9f2c...",
      "status": "answered",
      "product": {
        "channel": "1688",
        "source_product_id": "554456348334",
        "product_url": "https://detail.1688.com/offer/554456348334.html",
        "canonical_product_url": "https://detail.1688.com/offer/554456348334.html",
        "title": "...", "image": "...", "shop_id": "...", "shop_name": "..."
      },
      "sku": { "id": "3245:12345", "label": "블랙 / XL" },
      "message_count": 2,
      "last_message_at": "2026-05-20T10:02:00.000Z",
      "created_at": "2026-05-20T08:31:11.000Z",
      "updated_at": "2026-05-20T11:40:00.000Z"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 1, "total_pages": 1 },
  "request_id": "req_..."
}

알 수 없는 status나 channel은 400으로 거부되므로, 오타 때문에 전체 목록이 조용히 반환되는 일은 없습니다.

문의 상세

GET /v1/supplier-inquiries/{inquiry_id}는 요약 정보와 함께 전체 대화 및 간략한 타임라인을 반환합니다.

{
  "id": "sinq_9f2c...",
  "status": "answered",
  "product": {
    "channel": "1688",
    "source_product_id": "554456348334",
    "...": "..."
  },
  "sku": {
    "id": "3245:12345",
    "label": "블랙 / XL"
  },
  "message_count": 2,
  "messages": [
    {
      "id": "smsg_1a4b...",
      "type": "initial",
      "status": "answered",
      "questions": [
        {
          "id": "sqst_...",
          "type": "packed_weight",
          "note": "소매 박스를 포함한 중량",
          "question": null,
          "status": "answered",
          "answer": {
            "question_id": "sqst_...",
            "type": "packed_weight",
            "status": "answered",
            "value": 1250,
            "unit": "g",
            "provider_note": null,
            "answered_at": "2026-05-20T11:40:00.000Z"
          }
        }
      ],
      "attachments": [
        {
          "id": "satt_...",
          "type": "image",
          "url": "https://files.example.com/packaging.jpg",
          "filename": "supplier-packaging.jpg",
          "mime_type": "image/jpeg",
          "source": "supplier",
          "expires_at": null,
          "created_at": "2026-05-20T11:40:00.000Z"
        }
      ],
      "provider_note": null,
      "created_at": "2026-05-20T08:31:12.000Z",
      "answered_at": "2026-05-20T11:40:00.000Z"
    }
  ],
  "timeline": [
    {
      "message_id": "smsg_1a4b...",
      "type": "initial",
      "status": "answered",
      "created_at": "2026-05-20T08:31:12.000Z",
      "answered_at": "2026-05-20T11:40:00.000Z"
    }
  ],
  "request_id": "req_..."
}

question은 other 유형의 질문에서만 null이 아닙니다. 아직 답변되지 않은 질문은 status: "pending"과 answer: null을 가집니다.

attachments는 해당 메시지에 달린 파일 참조 목록으로, 여러분이 보낸 것과 공급업체 측에서 공유한 것이 함께 포함됩니다. source(developer, operator, supplier, system)로 구분할 수 있습니다. 문의 서비스가 내부용으로 보관하는 파일은 여기에 반환되지 않습니다. HIOBuy는 이 파일들을 호스팅하지 않습니다. url은 제공자 또는 여러분 자신의 스토리지를 가리키며, expires_at이 null이 아니라면 그 시점 이후로 해당 URL이 열리지 않을 수 있습니다.

메시지만 조회

GET /v1/supplier-inquiries/{inquiry_id}/messages는 상품 블록을 제외한 동일한 메시지 객체를 반환합니다. 이미 문의 정보를 보유하고 있고 새 답변만 확인하면 될 때 더 가벼운 호출입니다.

{
  "inquiry_id": "sinq_9f2c...",
  "status": "answered",
  "data": [ /* messages, oldest first */ ],
  "request_id": "req_..."
}

폴링과 웹훅 비교

supplier_inquiry.message_answered 웹훅을 우선 사용하세요. 페이로드에 이미 전체 answers 배열이 담겨 있어 알림만으로 충분한 경우가 많습니다. 폴링을 사용한다면 메시지 엔드포인트를 분 단위 주기로 호출하세요. 답변은 사람이 처리하는 속도로 도착하므로 몇 초 간격 폴링은 요청 한도만 소모합니다.

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support