Importstatus ophalen#

Het statuseindpunt retourneert de huidige of meest recente importtaak voor de winkel.

http

GET https://sdkapi.ideal.house/product-import/products/status?shopId=<SHOP_ID>

Queryparameters#

Veld	Type	Vereist	Beperkingen	Beschrijving
`shopId`	string	Ja	Maximaal 64 tekens	Shop ID die bij het indienen van de batch is gebruikt.

cURL-voorbeeld#

bash

curl --request GET \
  'https://sdkapi.ideal.house/product-import/products/status?shopId=shop_123' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Client-Secret: <YOUR_CLIENT_SECRET>'

Antwoordvelden#

Veld	Type	Beschrijving
`jobId`	string	Identificatie van de importtaak.
`shopId`	string	Winkel die aan de taak is gekoppeld.
`status`	string	Een van `pending`, `running`, `completed`, of `failed`.
`totalCount`	number	Totaal aantal ingediende producten.
`processedCount`	number	Aantal tot nu toe verwerkte producten.
`successCount`	number	Aantal producten dat succesvol is aangemaakt of bijgewerkt.
`failedCount`	number	Aantal producten waarvan de afzonderlijke verwerking is mislukt.
`failures`	array	Fouten op artikelniveau. Leeg als er geen fouten op artikelniveau zijn opgetreden.
`createdAt`	string	Aanmaaktijdstip van de taak in ISO 8601-formaat.
`startedAt`	string or null	Starttijd van verwerking in ISO 8601-formaat.
`updatedAt`	string	Laatste taakupdatetijd in ISO 8601-indeling.
`completedAt`	string or null	Eindtijdstip van de taak in ISO 8601-formaat.
`error`	string or null	Fout op taakniveau. Dit veld is normaal gesproken alleen ingevuld wanneer `status` de waarde `failed` heeft.

processedCount is gelijk aan successCount + failedCount.

successCount bevestigt dat het product in de catalogus is aangemaakt of bijgewerkt. Dit betekent niet noodzakelijk dat de beeldverwerking is geslaagd of dat het product direct kan worden weergegeven.

Elk object in failures bevat:

Veld	Type	Beschrijving
`index`	number	Positie van het product in de oorspronkelijke array `products`, geteld vanaf nul.
`sku`	string	SKU van het product waarvan de verwerking is mislukt.
`message`	string	Beschrijving van de fout. Bouw geen applicatielogica die afhankelijk is van de exacte berichttekst.

Taakstatussen#

Status	Betekenis	Aanbevolen actie
`pending`	Het verzoek is geaccepteerd en wacht tot de verwerking begint.	Blijf de status regelmatig opvragen.
`running`	De producten worden verwerkt.	Blijf de status opvragen en gebruik de tellervelden om de voortgang te tonen.
`completed`	De verwerking van de batch is voltooid. De verwerking van sommige producten kan zijn mislukt.	Controleer `failedCount` en `failures`.
`failed`	Een fout op taakniveau verhinderde dat de batch normaal werd voltooid.	Controleer `error` en probeer het vervolgens opnieuw zoals hieronder beschreven.

Voltooide taak met een fout op itemniveau#

json

{
  "jobId": "1930000000000000000",
  "shopId": "shop_123",
  "status": "completed",
  "totalCount": 2,
  "processedCount": 2,
  "successCount": 1,
  "failedCount": 1,
  "failures": [
    {
      "index": 1,
      "sku": "SKU-10002",
      "message": "Unable to import the remote image"
    }
  ],
  "createdAt": "2026-07-21T06:30:00.000Z",
  "startedAt": "2026-07-21T06:30:00.010Z",
  "updatedAt": "2026-07-21T06:30:08.000Z",
  "completedAt": "2026-07-21T06:30:08.000Z",
  "error": null
}

De status completed betekent dat het verwerkingsproces van de batch is afgerond; niet dat elk product succesvol is verwerkt. Een fout bij één product stopt de verwerking van andere producten in dezelfde batch niet.