### 调用 PDB 数据库 RESTful API 的方法 PDB（Protein Data Bank）提供了一个基于 RESTful 架构的 API 接口，允许开发者通过 HTTP 请求获取蛋白质结构数据和其他相关信息。以下是使用 Python 编写爬虫程序并调用 PDB RESTful API 的具体方法。 #### 使用 `requests` 库发送请求 Python 中最常用的 HTTP 客户端库是 `requests`，它能够轻松处理 GET 和 POST 请求。为了访问 PDB 数据库中的资源，可以构建 URL 并传递必要的参数来检索所需的数据[^1]。 ```python import requests def fetch_pdb_data(pdb_id): url = f"https://data.rcsb.org/rest/v1/core/entry/{pdb_id}" response = requests.get(url) if response.status_code == 200: data = response.json() return data else: raise Exception(f"Failed to retrieve data for {pdb_id}. Status code: {response.status_code}") # Example usage try: pdb_info = fetch_pdb_data("7CEI") # Replace with your desired PDB ID print(pdb_info["struct"]["title"]) except Exception as e: print(e) ``` 上述代码展示了如何通过指定的 PDB ID 获取对应条目的基本信息，并提取其标题字段作为示例输出。 --- #### 处理复杂查询条件 如果需要更复杂的过滤器或者额外的信息层，则可以通过调整路径或附加查询字符串完成。例如： - **按分类筛选**: `/rest/v1/search/category_search` - **高级搜索**: 支持关键词匹配、日期范围等多种选项。 下面是一个利用高级搜索功能的例子，用于查找特定时间段内的新提交记录。 ```python def search_entries_by_date(start_date, end_date): base_url = "https://search.rcsb.org/rcsbsearch/v1/query" query = { "query": { "type": "terminal", "service": "text", "parameters": { "attribute": "rcsb_accession_info.initial_release_date", "operator": "between", "value": {"from": start_date, "to": end_date} } }, "return_type": "entry" } headers = {'Content-Type': 'application/json'} response = requests.post(base_url, json=query, headers=headers) if response.status_code == 200: results = response.json()["result_set"] ids = [item['identifier'] for item in results] return ids else: raise Exception(f"Search failed. Status code: {response.status_code}") # Usage example recent_ids = search_entries_by_date("2023-01-01", "2023-12-31") print(recent_ids[:5]) # Print first five IDs found within the date range. ``` 此脚本定义了一种灵活的方式来定制化搜索逻辑，适用于多种实际需求场景[^2]。 --- #### 结合 FastAPI 实现服务接口 对于某些项目而言，可能希望创建自己的 Web Service 来封装这些外部 API 呼叫过程。这里给出一段简单的 FastAPI 示例代码展示这一思路。 ```python from fastapi import FastAPI app = FastAPI() @app.get("/pdb/{pdb_id}") async def get_pdb_entry(pdb_id: str): try: info = fetch_pdb_data(pdb_id) return {"status": "success", "data": info} except Exception as err: return {"status": "error", "message": str(err)} ``` 启动该应用之后即可对外暴露统一入口供其他客户端消费。 --- ### 注意事项 当频繁向第三方服务器发起大量请求时，请务必遵循目标站点的服务条款以及速率限制规定以免造成不必要的麻烦。