POST
https://api.nexscope.ai/md/checkApiFlashRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/md/checkApiFlash |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
mainProductImage | string | required | Main product image, which can be a public image URL or a Base64 data URI prefixed with `data:image/...;base64,`; the maximum length is 1000 |
referenceImages | string[] | optional | Array of similar product reference pictures, the elements are URL or data URI, up to 3 pictures |
otherProductImages | string[] | optional | Array of additional product images, the elements are URL or data URI, up to 5 images |
ipImages | string[] | optional | Array of pictures related to intellectual property, the elements are URL or data URI, up to 3 pictures |
referenceText | string | optional | Similar product text, such as product title; maximum length 1000 characters |
description | string | optional | Product description, it is recommended to fill in only the product title; the maximum length is 1000 characters |
ipKeywords | string[] | optional | Array of keywords related to intellectual property, up to 20 |
language | string | optional | Legal assessment report language, affects `report` field only; optional `zh` or `en` Example: zh |
Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
No response example is published for this API. Refer to the response fields below.
Response fields
Response field reference (25 fields)
| Name | Type | Required | Description |
|---|---|---|---|
errcode | integer | optional | Business status code, `200` indicates success |
errmsg | string | optional | Status description, `ok` when successful |
status | string | optional | Analyze the overall status, `success` when successful |
checkId | string | optional | The unique identifier for this test |
type | string | optional | Rendering style, such as `tableListWorkbenches` |
costToken | integer | optional | The token consumed by this call |
total | integer | optional | The number of high-risk infringement items, that is, the length of the `results` array |
riskLevel | string | optional | Overall risk assessment: `High Risk`, `Medium Risk` or `Low Risk` |
results | array | optional | List of high-risk potential infringement items, please see the "Infringement Item Fields" below for the fields. |
nonResults | array | optional | A list of IP items that are not high risk or low similarity, including information about possible TRO plaintiffs. See the "Infringement Item Fields" below for the fields. |
columns | array | optional | Rendered column definitions for display only; length may differ from data array |
ipType | string | optional | IP type: `Trademark`, `Copyright` or `Patent` |
text | string | optional | IP text content such as trademark text, patent title, or copyright title |
ipOwner | string | optional | Intellectual property right holder |
regNo | string | optional | Registration number, possibly an array of JSON strings, such as `["1221667"]` |
riskLevel | string | optional | Risk level: `High Risk`, `Medium Risk`, or `Low Risk`; does not appear if there is no rating |
riskScore | number | optional | 0-10 Numeric risk score; does not appear if there is no score |
riskDescription | string | optional | Risk level text description; does not appear if there is no score |
ipAssetUrls | string[] | optional | IP Evidence Image URL List |
plaintiffId | integer | optional | TRO Plaintiff ID, only appears if the IP appears in a TRO case |
plaintiffName | string | optional | TRO plaintiff name, appears only if the IP appears in a TRO case |
numberOfCases | integer | optional | Number of cases filed by this plaintiff; may be `null` if case details are not available |
lastCaseDocket | string | optional | Court docket number of the most recent case; may be `null` if case details are not available |
lastCaseDateFiled | string | optional | Date the most recent case was filed; may be `null` if case details are not available |
report | string | optional | AI-generated legal assessment report, the language is determined by the `language` parameter |
Responses
| Code | Description |
|---|---|
| 200 | Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result. |
| 429 | Execution admission rate limit; honor Retry-After when present. |
| 503 | Execution admission is temporarily unavailable; honor Retry-After when present. |
| Opt-in | X-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses. |
Data source, freshness, and limitations
Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.