https://api.nexscope.ai/api/skill-api/v1/skills/zhihuiya-utility-patent-image-search/runEjecutar 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/api/skill-api/v1/skills/zhihuiya-utility-patent-image-search/run |
| 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) Ejemplo: https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg |
patentType | string | obligatorio | Tipo de patente: U para una patente de modelo de utilidad. Ejemplo: U |
model | integer | obligatorio | Modelo de búsqueda de imágenes. Patentes de diseño: 1 (asociación inteligente, recomendada) o 2 (busca esta imagen). Patentes de modelos de utilidad: 3 (forma de partido) o 4 (forma de partido, patrón y color; recomendado) Ejemplo: 4 |
country | string | opcional | Códigos de autoridad de patentes para países, organizaciones o regiones, separados por comas, por ejemplo CN,US,JP. Omitan buscar todas las autoridades de patentes |
loc | string | opcional | Clasificaciones LOC (números de clasificación Locarno). Únase a varias clasificaciones con AND, O, O NO |
legalStatus | string | opcional | Valores: 1 (publicado), 2 (examen sustantivo), 3 (concedido), 8 (evitación de la subvención duplicada), 11 (retirada), 12 (retirada), 17 (retirada), 18 (retirada voluntaria), 13 (rechazada), 14 (rechazada íntegramente), 15 (expirada), 16 (no pagada), 21 (restaurados), 22 (derechos terminados), 23 (parcialmente inválidos), 24 (retirada), 30 (abandonada), 19 (dejada en suspenso), 20 (rechazada voluntariamente), 25 (retirada voluntaria), 222 (PCT no entró en el estado designado dentro del período de designación), 223 (PCT entró en el estado designado dentro del período de designación), 224 (PCT entró en el estado designado después del período de designación), y 225 (PCT no entró en el estado designado después del período de designación) |
simpleLegalStatus | string | opcional | Valores: 0 (inactivo), 1 (activo), 2 (pendiente), 220 (expiración del período de designación del PCT), 221 (dentro del período de designación del PCT) y 999 (no confirmado) |
assignees | string | opcional | Solicitante o titular de la patente (máximo 1.000 caracteres) |
applyStartTime | string | opcional | Fecha de inicio de la solicitud de patente: yyyyMMdd formato |
applyEndTime | string | opcional | Fecha de finalización de la solicitud de patente: yyyyMMdd formato |
publicStartTime | string | opcional | Fecha de inicio de la publicación de la patente: yyyyMMdd formato |
publicEndTime | string | opcional | Fecha de finalización de la publicación de la patente: yyyyMMdd formato |
limit | integer | opcional | Número de patentes que se devuelven, de 1 a 100. Valor predeterminado: 10. Ejemplo: 10 |
offset | integer | opcional | Desplazamiento de los resultados, de 0 a 1.000. Valor predeterminado: 0. Ejemplo: 0 |
field | string | opcional | Campo de ordenación del resultado: SCORE (pertinencia), APD (fecha de la solicitud), PBD (fecha de publicación) o ISD (fecha de la subvención). |
order | string | opcional | Disponible cuando el campo es APD, PBD o ISD: desc (descendente) o asc (ascendente). |
lang | string | opcional | Idioma preferido: original (título original de la patente), cn (título traducido al chino) o es (título traducido al inglés). |
preFilter | integer | opcional | Si se debe activar el prefiltrado de país/LOC: 1 para activado y 0 para desactivado. Default: 1 Ejemplo: 1 |
stemming | integer | opcional | Si se debe activar el frenado: 1 para activado y 0 para desactivado. Por defecto: 0 Ejemplo: 0 |
mainField | string | opcional | Campos primarios de patentes, incluyendo título, resumen, reclamaciones, especificación, número de publicación, número de solicitud, solicitante, inventor, y IPC/UPC/LOC clasificaciones (máximo 1.000 caracteres) |
includeMachineTranslation | boolean | opcional | Incluir datos traducidos por máquina en la búsqueda Ejemplo: false |
scoreExpansion | boolean | opcional | Ampliación de la puntuación Ejemplo: false |
isHttps | integer | opcional | Si se debe devolver imágenes sobre HTTPS: 1 para HTTPS y 0 para HTTP. Predeterminado: 0 Ejemplo: 0 |
returnImgId | boolean | opcional | Si se debe devolver img_id. Predeterminado: falso Ejemplo: false |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
{
"code": 0,
"cost": "-1",
"data": {
"allRecordsCount": 1,
"columns": [],
"costToken": 1,
"data": [
{
"apdt": 1,
"imgId": "example-id",
"loc": [],
"locMatch": 1,
"patentId": "example-id",
"pbdt": 1,
"score": 1,
"url": "https://example.com/image.jpg"
}
],
"total": 1
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 significa aceptado o exitoso; no cero es un error de plataforma. |
cost | string | obligatorio | Se pasó milisegundos, nunca créditos; -1 peticiones externas de la web. |
data | any | obligatorio | Valor de Data usado por esta operación de API. |
msg | string | null | obligatorio | Valor de Msg usado por esta operación de API. |
time | string | obligatorio | Hora local del servidor: aaaa-mm-dd HH:mm:ss. |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Epoch milisegundos. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.allRecordsCount | integer | opcional | Número total de registros coincidentes en la base de datos Ejemplo: 1 |
data.columns | array | opcional | Definiciones de columnas utilizadas para la renderización Ejemplo: [] |
data.costTime | integer | opcional | Tiempo de ejecución comunicado por el proveedor de aguas arriba. Ejemplo: null |
data.costToken | integer | opcional | Tokens consumidos Ejemplo: 1 |
data.data | array | opcional | Registros de patentes coincidentes Ejemplo: [] |
data.data[] | object | obligatorio | Elemento de data data. |
data.data[].apdt | integer | opcional | Fecha de la aplicación (modelo de tiempo) Ejemplo: 1 |
data.data[].apno | string | opcional | Número de la solicitud Ejemplo: null |
data.data[].authority | string | opcional | Autoridad de patentes (código del país) Ejemplo: null |
data.data[].currentAssignee | string | opcional | Asignatario actual Ejemplo: null |
data.data[].imgId | string | opcional | Dibujo de patentes img_id, regresó sólo cuando returnImgId es verdad Ejemplo: example-id |
data.data[].inventor | string | opcional | Inventor Ejemplo: null |
data.data[].loc | array | opcional | Clasificación de los LOC (número de clasificación de Locarno) Ejemplo: [] |
data.data[].locMatch | integer | opcional | Si una clase LOC de alto peso coincide: 1 para igualar y 0 para no igualar. Disponible sólo cuando modelo=1 y campo=SCORE Ejemplo: 1 |
data.data[].originalAssignee | string | opcional | Cesionario original Ejemplo: null |
data.data[].patentId | string | opcional | Identificación de patente similar Ejemplo: example-id |
data.data[].patentPn | string | opcional | Número de patente similar Ejemplo: null |
data.data[].pbdt | integer | opcional | Fecha de publicación (horario) Ejemplo: 1 |
data.data[].score | number | opcional | Puntuación de similitud; valores más altos indican mayor similitud. Disponible sólo cuando el campo es SCORE Ejemplo: 1 |
data.data[].title | string | opcional | Título de la patente Ejemplo: null |
data.data[].url | string | opcional | URL del dibujo similar de la patente Ejemplo: https://example.com/image.jpg |
data.dataSnapshotMonth | string | opcional | Mes de instantánea de datos devuelto por el proveedor de aguas arriba. Ejemplo: null |
data.page | integer | opcional | Página actual devuelta por el proveedor de aguas arriba. Ejemplo: null |
data.pageItemCount | integer | opcional | El artículo cuenta con la página actual devuelta por el proveedor de aguas arriba. Ejemplo: null |
data.pageSize | integer | opcional | Tamaño de página devuelto por el proveedor de aguas arriba. Ejemplo: null |
data.sourceTool | string | opcional | Nombre de la herramienta de fuente específica del proveedor. Ejemplo: null |
data.sourceType | string | opcional | Tipo de plataforma de origen específico para el proveedor. Ejemplo: null |
data.title | string | opcional | Título de respuesta específico del proveedor. Ejemplo: null |
data.total | integer | opcional | Número de registros devueltos en esta respuesta Ejemplo: 1 |
data.totalPage | integer | opcional | El total de páginas devueltas por el proveedor de aguas arriba. Ejemplo: null |
data.type | string | opcional | Estilo de representación Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | null | obligatorio | Valor de Data usado por esta operación de API. |
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.