[P023]Application Domain

get

https://connect.patsnap.com/high-value-data/application-domain

Receive application domain classification data by patent_id or patent_number.

The API supports batch requests with a maximum of 100 patents, and more patent id or patent number are separated with English comma. Batch requests are deducted from traffic/costs, and will be deducted multiple times based on the number of successful results returned.

Request Parameters

List of parameters supported by this API endpoint

Name	Type	Example	Description
`lang`	`string`	`en`	Select the language , you can choose cn or en.
`patent_id`	`string`	`1a47a70d-6b54-4709-a72a-ed552781fcac,ef7d1252-2e0e-40c3-a44f-1bc1c86b7990`	patent_id
`patent_number`	`string`	`CN102681224A`	patent_number

Response Schema

Structure of the API response data

Field Name	Type	Example	Description
`data`	`array`	-	response data
`pn`	`string`	`CN102681224A`	Patent number
`lang`	`string`	`en`	language
`patent_id`	`string`	`ef7d1252-2e0e-40c3-a44f-1bc1c86b7990`	Patent id
`application_domain_data`	`array`	`Please check the form: NameLevel`	Application domain data
`name`	`string`	`声波诊断`	name
`level`	`integer<int32>`	`4`	level
`status` Required	`boolean`	`false`	Status
`error_msg`	`string`	`The request parameter format is incorrect！`	Error Message
`error_code` Required	`integer`	`0`	Error Code

Success Response Example

Example of a successful API response

JSON

{
  "data": [
    {
      "pn": "CN102681224A",
      "lang": "en",
      "patent_id": "ef7d1252-2e0e-40c3-a44f-1bc1c86b7990",
      "application_domain_data": [
        {
          "name": "声波诊断",
          "level": 4
        }
      ]
    }
  ],
  "status": true,
  "error_code": 0
}

Error Codes

List of possible error codes returned by this endpoint

Business Errors

Error Code	Description
`68300004`	Invalid parameter!
`68300005`	Search api failure!
`68300006`	Analytic basic access error!
`68300007`	Bad request!
`68300008`	Service error, please try again later!
`68300010`	The file does not comply with upload specifications!

Platform Errors

Error Code	Description
`67200000`	API call exceeds the total limit set by the platform!
`67200001`	API call exceeds the total limit set by the platform!
`67200002`	The current call rate is too fast, exceeding the current configuration limit QPS!
`67200003`	The key and secret parameters for applying for the token are incorrect or the client has been disabled!
`67200004`	The requested api does not have permission. Please contact our support personnel!
`67200005`	Insufficient account balance/number of calls!
`67200006`	The client has exceeded the activation validity period!
`67200007`	The current call exceeds the configured usage limit of the day!
`67200008`	Please check if the required apikey in the query parameter has been transmitted!
`67200009`	The apikey does not match the passed bearerToken. Please check if a valid token is being used!
`67200012`	The request is illegal!
`67200100`	The current server status is busy, request response timeout!
`67200101`	The API requested currently does not exist. Please check the request path!

HTTP Status Codes

Status Code	Description
`0`	Success
`401`	Unauthorized
`403`	Forbidden
`404`	Not Found

Performance Metrics

Expected performance characteristics for this endpoint

Normal Response Time

5000 ms

Max Response Time

10000 ms