Saltar al contenido principal
POST
Import Raw Matches
Cargue un CSV UTF-8 con country_code y currency, una clave API pública Bearer y un UUID en Idempotency-Key.
El país y la moneda son obligatorios, con dos y tres letras respectivamente, normalizadas a mayúsculas. La cabecera debe ocupar como máximo 64 KiB y omitir item_id, external_match_id, match_relation, match_method y match_confidence. Use el formato existente de CSV de competidores sin procesar. Los archivos que ya tienen coincidencias utilizan matched-snapshots. La solicitud multipart completa admite hasta 25 MiB, incluidos los campos y la estructura. Los controles de cobertura y eliminación no se aplican a esta ruta. Una respuesta correcta devuelve 202 y job_id. Consulte GET /v1/matching/jobs/{job_id}/progress. De forma predeterminada (match_catalog=true), el proceso sincroniza el catálogo y ejecuta la búsqueda automática. Para guardar datos y buscar coincidencias más adelante, añada -F "match_catalog=false" a la solicitud. Esta carga no sincroniza ni necesita un catálogo y no inicia la búsqueda. Todas las filas válidas permanecen en Price Radar, aunque no tengan coincidencia. Los resultados incluyen recuentos y hasta 200 ejemplos de rechazos. Se mantiene la validación del CSV: una importación con más del 2% de filas inválidas falla en lugar de guardar un conjunto parcial. En una carga sin búsqueda, result_summary.stored cuenta las filas válidas guardadas, accepted es igual a stored, rejected cuenta solo las filas de entrada inválidas y sent es igual a stored + rejected. row_errors contiene los errores de filas inválidas; las filas sin coincidencia no se rechazan. Con la búsqueda activada, los recuentos existentes no cambian y se omite stored. Guardar datos sin procesar no crea coincidencias ni actualiza los precios de las cuadrículas; busque coincidencias más adelante para publicarlos. Solo se ejecuta una carga de coincidencias por organización a la vez; otra carga simultánea devuelve 409. Un reintento idéntico devuelve el mismo trabajo sin iniciar otra ejecución. Cambiar los bytes del archivo, las opciones de mercado o match_catalog con la misma clave devuelve 409. Los vínculos de las claves se conservan indefinidamente. Las cargas abandonadas sin trabajo caducan tras 24 horas: mantenimiento elimina el archivo y la clave devuelve 410; use una nueva. Los archivos de trabajos terminados siguen la limpieza del worker existente. Los errores de autenticación devuelven 401, las solicitudes demasiado grandes 413 y los campos o cabeceras inválidos 422. Compruebe el estado final del trabajo incluso después de recibir 202.

Encabezados

Idempotency-Key
string<uuid>
requerido

Cuerpo

multipart/form-data
file
file
requerido
country_code
string
requerido
currency
string
requerido

Respuesta

Successful Response

Minimal handle returned by async enqueue endpoints.

The full job status is fetched separately via GET /v1/jobs/{id}.

job_id
string<uuid>
requerido