Lieferantenanfragen abrufen

Drei Lese-Endpunkte, die alle den Scope supplier_inquiry:read erfordern. Anfragen sind an die Anwendung gebunden, die sie erstellt hat: Die Anfrage-ID einer anderen Anwendung liefert 404 INQUIRY_NOT_FOUND zurück, nicht 403.

Anfragen auflisten

GET /v1/supplier-inquiries

Parameter	Beschreibung
`status`	Ein Anfragestatus (`pending`, `processing`, `waiting_supplier`, `answered`, `completed`, `failed`, `cancelled`)
`channel`	`1688` oder `taobao`
`source_product_id`	Exakte Produkt-ID des Marktplatzes
`created_after` / `created_before`	Zeitstempel nach ISO 8601
`page`	Standardwert `1`
`limit`	Standardwert `20`, maximal `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": "Schwarz / 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_..."
}

Ein unbekannter status oder channel wird mit 400 abgelehnt, sodass ein Tippfehler nie stillschweigend alle Datensätze zurückgibt.

Anfragedetails

GET /v1/supplier-inquiries/{inquiry_id} liefert die Zusammenfassung samt der gesamten Konversation und einer kompakten Zeitleiste.

{
  "id": "sinq_9f2c...",
  "status": "answered",
  "product": {
    "channel": "1688",
    "source_product_id": "554456348334",
    "...": "..."
  },
  "sku": {
    "id": "3245:12345",
    "label": "Schwarz / XL"
  },
  "message_count": 2,
  "messages": [
    {
      "id": "smsg_1a4b...",
      "type": "initial",
      "status": "answered",
      "questions": [
        {
          "id": "sqst_...",
          "type": "packed_weight",
          "note": "Gewicht inklusive Verkaufsverpackung",
          "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 ist nur bei other-Fragen ungleich null. Eine noch unbeantwortete Frage hat status: "pending" und answer: null.

attachments listet die Dateiverweise dieser Nachricht auf — die von Ihnen gesendeten sowie alle, die die Lieferantenseite mit Ihnen geteilt hat. source unterscheidet sie (developer, operator, supplier, system). Dateien, die der Anfrageservice intern hält, werden hier nie zurückgegeben. HIOBuy hostet diese Dateien nicht: url verweist auf den Speicher des Anbieters oder Ihren eigenen, und ein expires_at ungleich null ist der Zeitpunkt, ab dem diese URL möglicherweise nicht mehr auflöst.

Nur Nachrichten

GET /v1/supplier-inquiries/{inquiry_id}/messages liefert dieselben Nachrichtenobjekte ohne den Produktblock — der günstigere Aufruf, wenn Ihnen die Anfrage bereits vorliegt und Sie nur neue Antworten benötigen.

{
  "inquiry_id": "sinq_9f2c...",
  "status": "answered",
  "data": [ /* Nachrichten, älteste zuerst */ ],
  "request_id": "req_..."
}

Polling versus Webhooks

Bevorzugen Sie den Webhook supplier_inquiry.message_answered: Sein Payload enthält bereits das vollständige answers-Array, sodass die Benachrichtigung oft schon alles ist, was Sie brauchen. Wenn Sie stattdessen pollen, rufen Sie den Messages-Endpunkt im Minutentakt ab — Antworten treffen in menschlichen Zeiträumen ein, und ein Polling im Sekundentakt verbraucht nur Ihr Rate-Limit.

Get Support

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

Email support