openapi: 3.2.0
info:
title: Patsnap Open Platform AI Translation Drug Basic Data API
version: 1.0.0
description: OpenAPI specification for Patsnap Open Platform APIs, including patent search, analytics, and Eureka AI capabilities.
servers:
- url: https://connect.patsnap.com
description: Patsnap Open Platform API gateway
tags:
- name: Drug Basic Data
description: Drug Basic Data APIs.
paths:
/synapse/drug/detail:
get:
operationId: b018DrugDetail
summary: B018 Drug basic information
description: Obtain drug basic information about drugs, including name, target, disease, active organization, etc.
tags:
- Drug Basic Data
security:
- bearerAuth: []
responses:
'200':
description: Successful b018 drug basic information response.
content:
application/json:
schema:
$ref: '#/components/schemas/B018DrugDetailResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/synapse/drug/detail
parameters:
- name: drug_id
in: query
required: true
description: Drug ID, obtain this through the drug search interface or drug autocomplete interface
schema:
type: string
example: 11d208e0c26a4345946d95f92d9fcaf0
description: Drug ID, obtain this through the drug search interface or drug autocomplete interface
/synapse/drug/dev-status:
get:
operationId: b020DrugDevStatus
summary: B020 Drug Dev Status
description: Obtain drug dev status about organization, disease, country, phase etc.
tags:
- Drug Basic Data
security:
- bearerAuth: []
responses:
'200':
description: Successful b020 drug dev status response.
content:
application/json:
schema:
$ref: '#/components/schemas/B020DrugDevStatusResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/synapse/drug/dev-status
parameters:
- name: drug_id
in: query
required: true
description: Drug ID, obtain this through the drug search interface or drug autocomplete interface
schema:
type: string
example: 11d208e0c26a4345946d95f92d9fcaf0
description: Drug ID, obtain this through the drug search interface or drug autocomplete interface
- name: offset
in: query
required: false
description: Offset, default 0
schema:
type: integer
format: int64
example: '0'
description: Offset, default 0
- name: limit
in: query
required: false
description: Limit, default 10, max 100
schema:
type: integer
format: int64
example: '10'
description: Limit, default 10, max 100
/synapse/drug/approval:
get:
operationId: b019DrugApproval
summary: B019 Drug approval information
description: Obtain drug approval information about product, submission, etc.
tags:
- Drug Basic Data
security:
- bearerAuth: []
responses:
'200':
description: Successful b019 drug approval information response.
content:
application/json:
schema:
$ref: '#/components/schemas/B019DrugApprovalResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/synapse/drug/approval
parameters:
- name: drug_id
in: query
required: true
description: Drug ID, obtain this through the drug search interface or drug autocomplete interface
schema:
type: string
example: 68431d4745744d9e9e17a3073edd3920
description: Drug ID, obtain this through the drug search interface or drug autocomplete interface
/synapse/target/detail:
get:
operationId: b040TargetDetail
summary: B040 Target basic information
description: Obtain Target basic information about name, short name, alias etc.
tags:
- Drug Basic Data
security:
- bearerAuth: []
responses:
'200':
description: Successful b040 target basic information response.
content:
application/json:
schema:
$ref: '#/components/schemas/B040TargetDetailResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/synapse/target/detail
parameters:
- name: target_id
in: query
required: true
description: Target ID, obtain this through the target autocomplete interface
schema:
type: string
example: 9786d32e3d244a688ec6a60d2fe1b10b
description: Target ID, obtain this through the target autocomplete interface
/synapse/drug/special-approval:
get:
operationId: b021DrugSpecialApproval
summary: B021 Drug Regulatory Review
description: Obtain drug special approval about organization, disease, country, special review etc.
tags:
- Drug Basic Data
security:
- bearerAuth: []
responses:
'200':
description: Successful b021 drug regulatory review response.
content:
application/json:
schema:
$ref: '#/components/schemas/B021DrugSpecialApprovalResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/synapse/drug/special-approval
parameters:
- name: drug_id
in: query
required: true
description: Drug ID, obtain this through the drug search interface or drug autocomplete interface
schema:
type: string
example: 68431d4745744d9e9e17a3073edd3920
description: Drug ID, obtain this through the drug search interface or drug autocomplete interface
/synapse/drug/xdc:
get:
operationId: b047DrugXdc
summary: B047 Drug xdc
description: Obtain drug xdc about targeting moiety, payload, linker etc.
tags:
- Drug Basic Data
security:
- bearerAuth: []
responses:
'200':
description: Successful b047 drug xdc response.
content:
application/json:
schema:
$ref: '#/components/schemas/B047DrugXdcResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/synapse/drug/xdc
parameters:
- name: drug_id
in: query
required: true
description: Drug ID, obtain this through the drug search interface or drug autocomplete interface
schema:
type: string
example: 002ff1c130254b02983a9282528b4d1c
description: Drug ID, obtain this through the drug search interface or drug autocomplete interface
/synapse/target/analysis:
get:
operationId: b041TargetAnalysis
summary: B041 Target analysis
description: Obtain Target analysis about organization, disease, drug type etc.
tags:
- Drug Basic Data
security:
- bearerAuth: []
responses:
'200':
description: Successful b041 target analysis response.
content:
application/json:
schema:
$ref: '#/components/schemas/B041TargetAnalysisResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/synapse/target/analysis
parameters:
- name: target_id
in: query
required: true
description: Target ID, obtain this through the target autocomplete interface
schema:
type: string
example: 9786d32e3d244a688ec6a60d2fe1b10b
description: Target ID, obtain this through the target autocomplete interface
- name: type
in: query
required: true
description: 'Analysis type, enum: ORGANIZATION、DISEASE、DRUG_TYPE'
schema:
type: string
example: ORGANIZATION
description: 'Analysis type, enum: ORGANIZATION、DISEASE、DRUG_TYPE'
- name: roll_up
in: query
required: true
description: Should the aggregation start from the headquarters as the root node? true - yes, false - no. The default is true
schema:
type: boolean
example: 'true'
description: Should the aggregation start from the headquarters as the root node? true - yes, false - no. The default is true
/synapse/drug/approval/file:
post:
operationId: b059ApprovalFile
summary: B059 Drug approval file
description: Obtain drug approval file
tags:
- Drug Basic Data
security:
- bearerAuth: []
responses:
'200':
description: Successful b059 drug approval file response.
content:
application/json:
schema:
$ref: '#/components/schemas/B059ApprovalFileResponse'
'201':
description: Created.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/synapse/drug/approval/file
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/B059ApprovalFileRequest'
components:
schemas:
B021DrugSpecialApproval_CommonCountry:
type: object
properties:
country_id:
type: string
example: 676de5ba-893a-36bb-8683-c93306aaf769
description: Country/Location ID
alpha2_code:
type: string
example: US
description: Alpha Code
display_name:
type: array
example:
- lang: EN
name: United States
- lang: CN
name: 美国
description: Country/Location Name
items:
$ref: '#/components/schemas/B021DrugSpecialApproval_CommonName'
B047DrugXdc_GetDrugXdcResponseDto:
type: object
properties:
dar:
type: string
example: 3-4
description: DAR
linker:
$ref: '#/components/schemas/B047DrugXdc_CommonDictionary'
payload:
$ref: '#/components/schemas/B047DrugXdc_CommonDictionary'
antibody_type:
$ref: '#/components/schemas/B047DrugXdc_CommonDictionary'
conjugation_site:
$ref: '#/components/schemas/B047DrugXdc_CommonDictionary'
targeting_moiety:
$ref: '#/components/schemas/B047DrugXdc_CommonDrug'
B019DrugApproval_DrugApprovalEmaDto:
type: object
properties:
products:
type: array
example: Please check the form:ApprovalProductDto
description: Product Basic Info
items:
$ref: '#/components/schemas/B019DrugApproval_ApprovalProductDto'
submissions:
type: array
example: Please check the form:ApprovalSubmissionDto
description: Submission Basic Info
items:
$ref: '#/components/schemas/B019DrugApproval_ApprovalSubmissionDto'
B020DrugDevStatus_DrugDevStatus:
type: object
properties:
id:
type: string
example: 05f69ae72aeccf5a92c9f417efaa3b02
description: ID
country:
$ref: '#/components/schemas/B020DrugDevStatus_CommonCountry'
disease:
$ref: '#/components/schemas/B020DrugDevStatus_CommonDisease'
dev_status:
$ref: '#/components/schemas/B020DrugDevStatus_CommonDictionary'
organization:
$ref: '#/components/schemas/B020DrugDevStatus_CommonOrganization'
dev_status_time:
type: integer
format: int64
example: 1644105600000
description: Date
B018DrugDetail_CommonCountry:
type: object
properties:
country_id:
type: string
example: 676de5ba-893a-36bb-8683-c93306aaf769
description: Country/Location ID
alpha2_code:
type: string
example: US
description: Alpha Code
display_name:
type: array
example:
- lang: EN
name: United States
- lang: CN
name: 美国
description: Country/Location Name
items:
$ref: '#/components/schemas/B018DrugDetail_CommonName'
B019DrugApproval_DrugApprovalPmdaDto:
type: object
properties:
products:
type: array
example: Please check the form:ApprovalProductDto
description: Product Basic Info
items:
$ref: '#/components/schemas/B019DrugApproval_ApprovalProductDto'
B018DrugDetail_DrugResponseMilestoneTag:
type: object
properties:
date:
type: integer
format: int64
example: 1409788800000
description: milestone date
name:
type: array
example:
- lang: EN
name: FDA Approval
- lang: CN
name: FDA批准
description: milestone name
items:
$ref: '#/components/schemas/B018DrugDetail_CommonName'
B041TargetAnalysis_CommonDictionary:
type: object
properties:
display_name:
type: array
example:
- lang: EN
name: Autologous CAR-T
- lang: CN
name: 自体CAR-T
description: Dict Name
items:
$ref: '#/components/schemas/B041TargetAnalysis_CommonName'
normalized_id:
type: string
example: 2fbfdb3e92d942c48cbb0adb79f23526
description: Dict ID
B019DrugApproval_DosageFormAndRouteDto:
type: object
properties:
route:
type: array
example:
- display_name:
- lang: EN
name: Subcutaneous
- lang: CN
name: 皮下注射
normalized_id: 6e0ca63bc1734b7aa1ad7a4c846fb4ac
description: Route
items:
$ref: '#/components/schemas/B019DrugApproval_CommonDictionary'
dosage_from:
type: array
example:
- display_name:
- lang: EN
name: Injection
- lang: CN
name: 注射剂
normalized_id: 699243160d8d4fd8aa67da7ff18f90a9
description: Dosage Form
items:
$ref: '#/components/schemas/B019DrugApproval_CommonDictionary'
original_name:
type: string
example: Injection; Subcutaneous
description: Original Name
B019DrugApproval_GetDrugApprovalResponseDto:
type: object
properties:
ema:
$ref: '#/components/schemas/B019DrugApproval_DrugApprovalEmaDto'
fda:
$ref: '#/components/schemas/B019DrugApproval_DrugApprovalFdaDto'
nmpa:
$ref: '#/components/schemas/B019DrugApproval_DrugApprovalNmpaDto'
pmda:
$ref: '#/components/schemas/B019DrugApproval_DrugApprovalPmdaDto'
B021DrugSpecialApproval_CommonOrganization:
type: object
properties:
display_name:
type: array
example:
- lang: EN
name: Roche Holding AG
- lang: CN
name: 罗氏
description: Organization Name, Referencing "CommonName"
items:
$ref: '#/components/schemas/B021DrugSpecialApproval_CommonName'
organization_id:
type: string
example: 87bfaf037f8e60c9e25595cd98bb27e4
description: Organization ID
B040TargetDetail_GetTargetResponseDto:
type: object
properties:
alias:
type: array
example:
- lang: EN
name: CD279
description: Target Alias
items:
$ref: '#/components/schemas/B040TargetDetail_CommonName'
profile:
type: array
example:
- lang: EN
name: 'Inhibitory receptor on antigen activated T-cells '
description: Profile
items:
$ref: '#/components/schemas/B040TargetDetail_CommonName'
target_id:
type: string
example: 3cbd7b503dd84de6b6d150c6143989fb
description: Target ID
short_name:
type: array
example:
- lang: EN
name: PD-1
description: Target Short Name
items:
$ref: '#/components/schemas/B040TargetDetail_CommonName'
uniprot_id:
type: array
example:
- Q15116
description: UniProt ID
target_name:
type: array
example:
- lang: EN
name: Programmed cell death protein 1
description: Target Name
items:
$ref: '#/components/schemas/B040TargetDetail_CommonName'
B019DrugApproval_CommonName:
type: object
properties:
lang:
type: string
example: EN
description: Language
name:
type: string
example: Ranibizumab (Genentech)
description: Drug,Target,Organization,Disease,Country/Location,DICT,Mechanism Action Name
B021DrugSpecialApproval_DrugSpecialApprovalDto:
type: object
properties:
id:
type: string
example: c2df2c0cf4f64d5c86d61caa8edb7905
description: ID
country:
$ref: '#/components/schemas/B021DrugSpecialApproval_CommonCountry'
disease:
$ref: '#/components/schemas/B021DrugSpecialApproval_CommonDisease'
organization:
$ref: '#/components/schemas/B021DrugSpecialApproval_CommonOrganization'
approval_time:
type: integer
format: int64
example: 1559088000000
description: Date
special_review:
$ref: '#/components/schemas/B021DrugSpecialApproval_CommonDictionary'
B020DrugDevStatus_CommonName:
type: object
properties:
lang:
type: string
example: EN
description: Language
name:
type: string
example: Ranibizumab (Genentech)
description: Drug,Target,Organization,Disease,Country/Location,DICT,Mechanism Action Name
B019DrugApprovalResponse:
type: object
properties:
data:
$ref: '#/components/schemas/B019DrugApproval_GetDrugApprovalResponseDto'
status:
type: boolean
example: 'false'
description: Status
error_msg:
type: string
example: The request parameter format is incorrect!
description: Error Message
error_code:
type: integer
example: '0'
description: Error Code
required:
- status
- error_code
B040TargetDetail_CommonName:
type: object
properties:
lang:
type: string
example: EN
description: Language
name:
type: string
example: Ranibizumab (Genentech)
description: Drug,Target,Organization,Disease,Country/Location,DICT,Mechanism Action Name
B059ApprovalFileRequest:
type: object
properties:
drug_id:
type: string
example: 68431d4745744d9e9e17a3073edd3920
description: DRUG ID, MUST NOT be used with the 'approvalId' and 'approvalSource' field.
approval_id:
type: array
example:
- 25854e08d0e9858e89ad4438028589d2
description: Drug Approval ID, MUST be used with the 'approvalSource' field. Obtain this through the [B019] Drug approval information interface
approval_source:
type: string
example: FDA
description: 'Approval Source, MUST be used with the ''approvalId'' field.The value is an enum with the following values: FDA,EMA,PMDA,NMPA'
B018DrugDetail_SequenceDto:
type: object
properties:
chain_type:
type: array
example:
- L
description: Chain type
sequence_text:
type: string
example: DILLTQSPVILSVSPGERVSFSCRASQSIGTNIHWYQQRTNGSPRLLIKYASESISGIPSRFSGSGSGTDFTLSINSVESEDIADYYCQQNNNWPTTFGAGTKLELKRTVAAPSVFIFPPSDEQLKSGTASVVCLLNNFYPREAKVQWKVDNALQSGNSQESVTEQDSKDSTYSLSSTLTLSKADYEKHKVYACEVTHQGLSSPVTKSFNRGEC
description: Sequence Text
sequence_number:
type: integer
format: int64
example: 43254
description: Sequence number
B041TargetAnalysis_AnalysisDto:
type: object
properties:
id:
type: string
example: b4c624212749f84e83429c5a8673c692
description: ID
phase:
type: array
example:
- dev_status:
display_name:
- lang: EN
name: Pending
- lang: CN
name: 无进展
normalized_id: 4d95bf5fb0c340fbb38cda626c1c9c60
drug_count: 10
description: Phase, Referencing "PhaseDto"
items:
$ref: '#/components/schemas/B041TargetAnalysis_PhaseDto'
display_name:
type: array
example:
- lang: EN
name: Roche Holding AG
- lang: CN
name: 罗氏
description: Name, Referencing "CommonName"
items:
$ref: '#/components/schemas/B041TargetAnalysis_CommonName'
B040TargetDetailResponse:
type: object
properties:
data:
$ref: '#/components/schemas/B040TargetDetail_GetTargetResponseDto'
status:
type: boolean
example: 'false'
description: Status
error_msg:
type: string
example: The request parameter format is incorrect!
description: Error Message
error_code:
type: integer
example: '0'
description: Error Code
required:
- status
- error_code
B047DrugXdcResponse:
type: object
properties:
data:
$ref: '#/components/schemas/B047DrugXdc_GetDrugXdcResponseDto'
status:
type: boolean
example: 'false'
description: Status
error_msg:
type: string
example: The request parameter format is incorrect!
description: Error Message
error_code:
type: integer
example: '0'
description: Error Code
required:
- status
- error_code
B041TargetAnalysis_CommonName:
type: object
properties:
lang:
type: string
example: EN
description: Language
name:
type: string
example: Ranibizumab (Genentech)
description: Drug,Target,Organization,Disease,Country/Location,DICT,Mechanism Action Name
B047DrugXdc_CommonName:
type: object
properties:
lang:
type: string
example: EN
description: Language
name:
type: string
example: Ranibizumab (Genentech)
description: Drug,Target,Organization,Disease,Country/Location,DICT,Mechanism Action Name
B021DrugSpecialApproval_GetDrugSpecialApprovalResponseDto:
type: object
properties:
items:
type: array
example: Please check the form:DrugSpecialApprovalDto
description: Results
items:
$ref: '#/components/schemas/B021DrugSpecialApproval_DrugSpecialApprovalDto'
total:
type: integer
format: int64
example: 0
description: total
B021DrugSpecialApproval_CommonDictionary:
type: object
properties:
display_name:
type: array
example:
- lang: EN
name: Autologous CAR-T
- lang: CN
name: 自体CAR-T
description: Dict Name
items:
$ref: '#/components/schemas/B021DrugSpecialApproval_CommonName'
normalized_id:
type: string
example: 2fbfdb3e92d942c48cbb0adb79f23526
description: Dict ID
B019DrugApproval_ApprovalProductDto:
type: object
properties:
appl_no:
type: string
example: 125057
description: FDA Application ID
generic:
type: integer
format: int32
example: 0
description: 'Generic, 0: No, 1: Yes'
strength:
type: string
example: 40MG/0.8ML
description: Strength
appl_type:
type: string
example: BLA
description: Application Type
pack_size:
type: string
example: 25854e08d0e9858e89ad4438028589d2
description: Package Size
biosimilar:
type: integer
format: int32
example: 0
description: 'Biosimilar, 0: No, 1: Yes'
product_no:
type: string
example: 25854e08d0e9858e89ad4438028589d2
description: EMA Production Number
trade_name:
type: array
example:
- lang: EN
name: HUMIRA
description: Trade Name
items:
$ref: '#/components/schemas/B019DrugApproval_CommonName'
data_source:
type: string
example: FDA_CDER
description: Data Source
approval_date:
type: integer
format: int64
example: 25854e08d0e9858e89ad4438028589d2
description: Approval Date
market_status:
$ref: '#/components/schemas/B019DrugApproval_CommonDictionary'
special_review:
type: array
example:
- display_name:
- lang: EN
name: Additional Monitoring
- lang: CN
name: 额外监测
normalized_id: 30ffad249563481eb8fcfe4a7342269a
description: Special Review
items:
$ref: '#/components/schemas/B019DrugApproval_CommonDictionary'
applicant_holder:
type: array
example:
- display_name:
- lang: EN
name: AbbVie, Inc.
organization_id: d88590e686ad5608bbbfeb811b14d188
description: Organization
items:
$ref: '#/components/schemas/B019DrugApproval_CommonOrganization'
drug_approval_id:
type: string
example: 25854e08d0e9858e89ad4438028589d2
description: Drug Approval Id
last_update_date:
type: integer
format: int64
example: 1722384000000
description: Last Update
first_approval_date:
type: integer
format: int64
example: 25854e08d0e9858e89ad4438028589d2
description: First Approval Date
product_data_source:
type: array
example:
- lang: EN
name: Orange Book
- lang: CN
name: 橙皮书
description: Product Data Source
items:
$ref: '#/components/schemas/B019DrugApproval_CommonName'
product_presentation:
type: string
example: Blister (PVC/PE/PVDC/alu)
description: Package Type
content_concentration:
type: string
example: 0.8 ml (40 mg/0.8 ml)
description: Volume
dosage_form_and_route:
$ref: '#/components/schemas/B019DrugApproval_DosageFormAndRouteDto'
B019DrugApproval_ApprovalSubmissionDto:
type: object
properties:
disease:
type: array
example:
- disease_id: e6ee5660ea1d44ad8edb142046da866f
display_name:
- lang: EN
name: Enthesitis-Related Arthritis
- lang: CN
name: 附着点炎相关关节炎
description: Indication
items:
$ref: '#/components/schemas/B019DrugApproval_CommonDisease'
regulation:
type: array
example: STANDARD; Orphan
description: Approval Category
items:
$ref: '#/components/schemas/B019DrugApproval_CommonDictionary'
action_date:
type: integer
format: int64
example: 1698969600000
description: EMA Approval Date
action_type:
type: string
example: Approval
description: Result
approval_date:
type: integer
format: int64
example: 1698969600000
description: FDA Approval Date
market_status:
$ref: '#/components/schemas/B019DrugApproval_CommonDictionary'
submission_no:
type: integer
format: int64
example: 423
description: Submission No
submission_type:
type: string
example: SUPPL
description: Submission Type
drug_approval_id:
type: string
example: 25854e08d0e9858e89ad4438028589d2
description: Drug Approval Id
original_regulation:
type: string
example: STANDARD; Orphan
description: Approval Category Original Value
submission_classification:
type: string
example: Labeling
description: Registration Category
B018DrugDetail_CommonDictionary:
type: object
properties:
display_name:
type: array
example:
- lang: EN
name: Autologous CAR-T
- lang: CN
name: 自体CAR-T
description: Dict Name
items:
$ref: '#/components/schemas/B018DrugDetail_CommonName'
normalized_id:
type: string
example: 2fbfdb3e92d942c48cbb0adb79f23526
description: Dict ID
B018DrugDetail_DrugResponseTarget:
type: object
properties:
hgnc_id:
type: array
example:
- HGNC:12680
description: List of HGNC IDs
mesh_id:
type: array
example:
- '7422'
description: List of MESH IDs
target_id:
type: string
example: 1c2067e5ab054a8995f73efcfcf56207
description: Target ID
short_name:
type: array
example:
- lang: EN
name: VEGF
description: Target Short Name, Referencing "CommonName"
items:
$ref: '#/components/schemas/B018DrugDetail_CommonName'
gene_symbol:
type: array
example:
- lang: EN
name: VEGFA
description: Gene Symbol
items:
$ref: '#/components/schemas/B018DrugDetail_CommonName'
display_name:
type: array
example:
- lang: EN
name: Vascular en
# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/patsnap/refs/heads/main/openapi/patsnap-drug-basic-data-api-openapi.yml