[B066] 亲和力检索

get
https://connect.zhihuiya.com/synapse/bio/affinity/search
在体验中心中试用

通过亲和力ID查询抗体与抗原的亲和力详细信息，包括抗体序列、抗原信息、测定方法、测定条件等

affinity_id 为必填参数，可从[B065]接口的返回结果中获取

请求参数

此 API 接口支持的参数列表

名称类型示例描述
affinity_id
必填
stringn14778540229713683257531356477449681766
亲和力查询ID
page
integer<int32>1
页码（必须>=1）
rows
integer<int32>10
每页条数（必须>=1且<=10）

响应结构

API 响应数据的结构说明

字段名类型示例描述
data
object-
响应数据
page
integer<int32>1
当前页码
rows
integer<int32>10
每页条数
total
integer<int64>100
总量
source
objectPlease check the form: AntibodyPatentInfo
来源信息
source_type
stringpatent
数据来源类型
antibody_patent_id
stringAB_12345678
抗体专利ID
antibody_patent_number
stringCN302052315S
专利公开号
heavy_chain_sequence_id
stringHC_12345678
智慧芽内部重链序列编码
light_chain_sequence_id
stringLC_12345678
智慧芽内部轻链序列编码
antigen_name
stringCD19
抗原名称
antibody_name
array[ "Rituximab" ]
抗体名称
antigen_species
stringHuman
抗原物种
antigen_uniport
arrayPlease check the form: AntibodyUniport
抗原UniProt列表
uniprot_id
stringP15391
抗原uniprot ID
uniprot_id_seq
stringMKLLVVVLFLGAETTGSTQQLIQESGPGLVAPSQSLSITCTVSGFSLTNYGVHWVRQSPGKGLEWLGVIWSGGNTDYNTPFTSRLSINKDNSKSQVFFKMNSLQSNDTAIYYCARDYRYDYWGQGTLVTVSS
抗原uniprot ID序列
affinity_details
arrayPlease check the form: AffinityDetail
亲和力列表
ph
string7.4
pH值
unit
string1/Ms
标准化单位
index
stringKd
指标
value
string198000
标准化值
method
stringSPR
测定方法
ori_unit
stringM^-1s^-1
原始单位
ori_value
string198000
原始值
temperature
stringroom temperature
温度
antibody_sequence
objectPlease check the form: AntibodySequenceInfo
抗体序列信息
antibody_heavy_chain
stringEVQLVESGGGLVQPGGSLRLSCAASGFTFSSYAMSWVRQAPGKGLEWVSAISGSGGSTYYADSVKGRFTISRDNSKNTLYLQMNSLRAEDTAVYYCARDYRYDYWGQGTLVTVSS
抗体重链序列
antibody_light_chain
stringDIQMTQSPSSLSASVGDRVTITCRASQDVNTAVAWYQQKPGKAPKLLIYSASFLYSGVPSRFSGSRSGTDFTLTISSLQPEDFATYYCQQHYTTPPTFGQGTKVEIK
抗体轻链序列
heavy_chain_sequence_number
integer<int64>123456789
重链序列编号
light_chain_sequence_number
integer<int64>987654321
轻链序列编号
status
必填
booleanfalse
状态
error_msg
stringThe request parameter format is incorrect！
错误信息
error_code
必填
integer0
错误代码

成功响应示例

成功调用 API 的响应示例

JSON 
{
  "data": {
    "page": 1,
    "rows": 10,
    "total": 100,
    "source": {
      "source_type": "patent",
      "antibody_patent_id": "AB_12345678",
      "antibody_patent_number": "CN302052315S",
      "heavy_chain_sequence_id": "HC_12345678",
      "light_chain_sequence_id": "LC_12345678"
    },
    "antigen_name": "CD19",
    "antibody_name": [
      "Rituximab"
    ],
    "antigen_species": "Human",
    "antigen_uniport": [
      {
        "uniprot_id": "P15391",
        "uniprot_id_seq": "MKLLVVVLFLGAETTGSTQQLIQESGPGLVAPSQSLSITCTVSGFSLTNYGVHWVRQSPGKGLEWLGVIWSGGNTDYNTPFTSRLSINKDNSKSQVFFKMNSLQSNDTAIYYCARDYRYDYWGQGTLVTVSS"
      }
    ],
    "affinity_details": [
      {
        "ph": 7.4,
        "unit": "1/Ms",
        "index": "Kd",
        "value": 198000,
        "method": "SPR",
        "ori_unit": "M^-1s^-1",
        "ori_value": 198000,
        "temperature": "room temperature"
      }
    ],
    "antibody_sequence": {
      "antibody_heavy_chain": "EVQLVESGGGLVQPGGSLRLSCAASGFTFSSYAMSWVRQAPGKGLEWVSAISGSGGSTYYADSVKGRFTISRDNSKNTLYLQMNSLRAEDTAVYYCARDYRYDYWGQGTLVTVSS",
      "antibody_light_chain": "DIQMTQSPSSLSASVGDRVTITCRASQDVNTAVAWYQQKPGKAPKLLIYSASFLYSGVPSRFSGSRSGTDFTLTISSLQPEDFATYYCQQHYTTPPTFGQGTKVEIK",
      "heavy_chain_sequence_number": 123456789,
      "light_chain_sequence_number": 987654321
    }
  },
  "status": true,
  "error_code": 0
}

错误码

此接口可能返回的错误码列表

业务错误码

错误码描述
68300004请求参数异常!
68300005查询Api失败!
68300006解析基本存取错误!
68300007存在错误的请求!
68300008服务中断异常，请稍后再试!
68300010文件不符合上传规范!

平台错误码

错误码描述
67200000API整体限流错误!
67200001API整体限流错误！
67200002当前调用速率过快,超过当前配置限制QPS！
67200003申请token的key和secret传参不正确或者客户端已被禁用！
67200004请求的接口无权限请联系我们的支持人员！
67200005账户余额/调用次数不足！
67200006客户端超过开通有效期！
67200007当前调用超过当天配置使用额度！
67200008请检查query参数中必填的apikey是否传输！
67200009apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token！
67200012请求不合法！
67200100当前服务器状态正忙,请求响应超时！
67200101当前请求的Api不存在请检查请求Path！

HTTP 状态码

状态码描述
0请求成功
401Unauthorized
403Forbidden
404Not Found

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms