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 | El número de registros devueltos esta vez. |
allRecordsCount | integer | opcional | El número total de registros coincidentes en la base de datos. |
data | array | opcional | Lista de registros de patentes coincidentes. |
columns | array | opcional | Definiciones de columna renderizadas. |
type | string | opcional | Estilo de representación. |
costToken | integer | opcional | Consumir token. |
patentId | string | opcional | Identifiquen una patente similar. |
patentPn | string | opcional | Números de patentes similares. |
apno | string | opcional | Número de solicitud. |
title | string | opcional | Nombre de patente. |
inventor | string | opcional | Inventor. |
originalAssignee | string | opcional | original. |
currentAssignee | string | opcional | Solicitantes actuales. |
authority | string | opcional | Código del país de la Oficina receptora. |
url | string | opcional | Dibujo similar de patente URL. |
score | number | opcional | Similaridad puntuación; cuanto mayor es la puntuación, más similar es, sólo válido cuando `field=SCORE`. |
loc | array | opcional | Clasificación de la LOC. |
locMatch | integer | opcional | Si se debe golpear con un LOC de alto peso: `1` golpes, `0` falla; sólo válido cuando `model=1` y `field=SCORE`. |
apdt | integer | opcional | Fecha de aplicación (horario). |
pbdt | integer | opcional | Fecha de publicación (horario). |
imgId | string | opcional | Dibujo de patentes `img_id`; devuelto sólo si `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 la ausencia de una clave API (code 11209), 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.