https://api.nexscope.ai/zy/patentImageSearchEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/zy/patentImageSearch |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
url | string | obligatorio | Imagen URL, máximo 1.000 caracteres. |
patentType | string | obligatorio | Tipo de patente: `D` (patente de apariencia) o `U` (patente modelo de utilidad); la habilidad del modelo de utilidad utiliza `U` permanentemente. |
model | integer | obligatorio | Patentes de apariencia: `1` (lenovo inteligente, recomendado), `2` (busque en esta imagen); modelos de utilidad: `3` (forma de emparejamiento), `4` (forma de emparejamiento)/pattern/color, recomendado). |
country | string | opcional | El país/organization/region código de la oficina de aceptación de patentes. Múltiples están separados por comas inglesas; si no se pasa, significa todas las oficinas de aceptación. |
loc | string | opcional | Clasificación LOC, múltiples números de clasificación se pueden conectar usando `AND`/`OR`/`NOT`. |
legalStatus | string | opcional | Códigos de estatuto legal detallados, múltiples separados por comas inglesas: `1` público, `2` examen sustantivo, `3` autorizados, `8` evitar la autorización repetida, `11` retirada, `12` tipo retirado no especificado, `17` Retirada - retirada considerada, `18` retirada - retirada activa, `13` rechazo, `14` toda retirada, `15` expiración del mandato, `16` comisión anual impagada, `21` la restauración de los derechos, `22` la terminación de los derechos, `23` Parcialmente inválido, `24` la solicitud se ha terminado, `30` abandonado, `19` abandonado - considerado abandonado, `20` abandonado - abandonado voluntario, `25` tipo abandonado - no especificado, `222` PCT no entró en el país designado - dentro del período designado, `223` PCT Entrar en el país designado - dentro del período de designación, `224` PCT que entra en el país designado - el período de designación expira, `225` PCT no entra en el país designado - el período de designación expira. |
simpleLegalStatus | string | opcional | Situación jurídica sencilla: `0` caducado, `1` válida, `2` en examen, `220` Expiración designada del PCT, `221` Período designado para el PCT, `999` no confirmado. |
assignees | string | opcional | Solicitante (derechos de patente), máximo 1.000 caracteres. |
applyStartTime | string | opcional | Fecha de inicio de la aplicación, formato `yyyyMMdd`. |
applyEndTime | string | opcional | Plazo de presentación de la solicitud, formato `yyyyMMdd`. |
publicStartTime | string | opcional | Fecha de inicio de la publicación, formato `yyyyMMdd`. |
publicEndTime | string | opcional | Plazo público, formato `yyyyMMdd`. |
limit | integer | opcional | Devuelve el número de patentes, 1–100. Ejemplo: 10 |
offset | integer | opcional | Offset, 0–1000. Ejemplo: 0 |
field | string | opcional | Campos de clasificación: `SCORE` (pertinencia), `APD` (fecha de la solicitud), `PBD` (fecha de publicación), `ISD` (fecha de autorización). Ejemplo: SCORE |
order | string | opcional | Válido cuando `field` es un campo de fecha: `desc` o `asc`. Ejemplo: desc |
lang | string | opcional | Lenguaje del título: `original` (texto original), `cn` (traducción al chino), `en` (Traducción al inglés). Ejemplo: original |
preFilter | integer | opcional | Indica si se debe activar el filtrado prefijo país/LOC: `1` está en marcha, `0` - No, no. Ejemplo: 1 |
stemming | integer | opcional | Si se debe encender el truncado: `1` está en marcha, `0` - No, no. Ejemplo: 0 |
mainField | string | opcional | Principales campos de patentes, incluyendo título, resumen, reivindicaciones, especificación, número de publicación, número de solicitud, solicitante, inventor y IPC/UPC/LOC Número de clasificación, máximo 1.000 caracteres. |
includeMachineTranslation | boolean | opcional | Si la búsqueda incluye datos de traducción automática. |
scoreExpansion | boolean | opcional | Si se debe realizar la expansión de puntuación. |
isHttps | integer | opcional | Protocolo de nombre de dominio de imagen: `1` devuelve HTTPS, `0` devuelve HTTP. Ejemplo: 0 |
returnImgId | boolean | opcional | Si se debe devolver `imgId`. Ejemplo: false |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.
Campos de respuesta
Referencia de campos de respuesta (21 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | The number of records returned this time. |
allRecordsCount | integer | opcional | The total number of matching records in the database. |
data | array | opcional | List of matching patent records. |
columns | array | opcional | Rendered column definitions. |
type | string | opcional | Rendering style. |
costToken | integer | opcional | Consume token. |
patentId | string | opcional | Similar patent ID. |
patentPn | string | opcional | Similar patent numbers. |
apno | string | opcional | Application number. |
title | string | opcional | Patent name. |
inventor | string | opcional | Inventor. |
originalAssignee | string | opcional | original applicant. |
currentAssignee | string | opcional | Current applicants. |
authority | string | opcional | Receiving Office country code. |
url | string | opcional | Similar patent drawing URL. |
score | number | opcional | Similarity score; the higher the score, the more similar it is, only valid when `field=SCORE`. |
loc | array | opcional | LOC classification. |
locMatch | integer | opcional | Whether to hit high weight LOC: `1` hits, `0` misses; only valid when `model=1` and `field=SCORE`. |
apdt | integer | opcional | Application date (timestamp). |
pbdt | integer | opcional | Publication date (timestamp). |
imgId | string | opcional | Patent drawing `img_id`; returned only if `returnImgId=true`. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.