PDB 注册与登录：拿到你的专属钥匙

讲真，PDB 数据库虽然开放给所有人用，但你要是想批量下载、用 API 拉数据，或者保存检索历史，那还是得有个账号。我个人习惯是先把账号注册好，再研究别的——这不光是为了权限，更重要的是，有了 API 密钥，你写脚本调数据时才不会被限流。

我刚开始做结构生物信息学那会儿，直接写 Python 请求库去抓 PDB 文件，结果 IP 被临时封了。后来才知道，匿名访问是有频率限制的。嗯，注册一个账号，拿到密钥，这些问题就都不是问题了。

注册账号：三步搞定

说白了，注册流程跟大多数科研网站差不多。你准备好一个邮箱，再给自己想个好记的用户名就行。

1. 打开 PDB 官网 https://www.rcsb.org/，点右上角的 “Log In” 按钮。
2. 在弹出的窗口里选择 “Create an account”。
3. 填写邮箱、用户名、密码。邮箱需要验证，不过很快。

注册完成后，你会收到一封验证邮件。点一下链接，账号就激活了。整个过程不超过 5 分钟。

登录与界面导航

登录之后，页面右上角会显示你的用户名。点进去，看到的是一个面板，里面有你的检索历史、收藏的结构列表，还有 API 密钥管理。

这里我特别提一下收藏列表——你在研究某个蛋白家族时，可以把相关的 PDB 条目都收藏起来，后面写论文对比结构时特别好用。我在做新冠病毒主蛋白酶（Mpro）的结构比对时，收藏了上百个条目，省了我反复搜索的功夫。

功能区域	说明	我的使用频率
Saved Structures	收藏的 PDB 条目，可打标签	很高
Search History	最近 30 天的搜索记录	较高
API Key Management	生成 / 撤销 API 令牌	偶尔
Account Settings	修改密码、邮箱、个人信息	低

API 密钥获取：真正的重点

为什么要搞 API 密钥？你想想看，如果你写个脚本一次下载 1000 个 PDB 文件，没有密钥的话，服务器可能直接拒绝你的请求。有了密钥，不仅有更高的请求配额，还能访问一些高级查询接口。

获取方式很简单：

1. 登录后，点击用户名 → “Account” → “API Key Management”。
2. 点 “Create New Key”，系统会生成一串类似 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 的字符串。
3. 复制密钥，保存到安全的地方。PDB 不会再次完整显示你的密钥。

拿到密钥后，怎么用？我一般在代码里用环境变量来存，而不是硬编码。

# 推荐做法：使用环境变量
export PDB_API_KEY="你的密钥"

# 在 Python 中读取
import os
api_key = os.getenv("PDB_API_KEY")
print(f"密钥已加载: {api_key[:8]}...")

用密钥请求数据：一个真实案例

拿到密钥后，我们来试一下。下面这个例子会通过 PDB 的 REST API 获取一个条目的基本信息。

import requests

# 你的密钥（从环境变量读取）
API_KEY = os.getenv("PDB_API_KEY")
HEADERS = {"X-API-Key": API_KEY}

# 请求 1ake（T4 溶菌酶）的基本信息
url = "https://data.rcsb.org/rest/v1/core/entry/1ake"
response = requests.get(url, headers=HEADERS)

if response.status_code == 200:
    data = response.json()
    print(f"结构 ID: {data['structure_id']}")
    print(f"标题: {data['struct']['title']}")
    print(f"实验方法: {data['exptl'][0]['method']}")
else:
    print(f"请求失败: {response.status_code}")

输出大概是这样的：

结构 ID: 1ake
标题: T4 LYSOZYME
实验方法: X-RAY DIFFRACTION

你看，加上密钥之后，响应速度明显比匿名快。而且你不用担心请求被限流——至少短时间内发上百个请求没问题。

上面这张图，从左到右展示了你的三个访问入口。左边是手动浏览器，中间是服务器，右边是自动化脚本。你想想看，从手动到自动化，这不就是效率的跃迁吗？

好，到现在为止，你应该已经注册好了账号，拿到了 API 密钥，也学会了怎么在代码里安全地使用它。后面的事情，就好办多了。