如何通过APISetu整合DigiLocker获取文档？回调与文件获取咨询

一、回调接口的说明 #

• 回调接口是你自己服务端必须搭建的接口，不是DigiLocker现成提供的。当初你在APISetu合作伙伴后台申请API密钥时，多半已经提交过这个接口的URL；要是没提交，现在赶紧去后台更新配置。
• 这个接口得支持POST请求，能接收DigiLocker传过来的授权码（code参数），后续靠这个码去换访问令牌。

二、调整API调用获取目标文档 #

1. 用授权码换访问令牌 #

DigiLocker调用你的回调接口时，会把授权码code带过来。你拿这个code调用令牌接口换access_token：

POST /oauth/token HTTP/1.1
Host: api.digilocker.gov.in
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&code=你的授权码&client_id=你的API密钥&client_secret=你的API密钥密码&redirect_uri=你的回调接口URL

返回结果里的access_token就是后续拉取文档的核心凭证。

2. 获取Aadhar和驾照文档 #

先用access_token调用文档列表接口，拿到用户所有已授权的文档元数据：

GET /v1/user/documents HTTP/1.1
Host: api.digilocker.gov.in
Authorization: Bearer 你的access_token

从返回的列表里筛出Aadhar（文档类型通常是aadhaar）和驾照（通常是driving_license）的document_id，再用这个ID调用详情接口拿原始文件：

GET /v1/document/你的document_id HTTP/1.1
Host: api.digilocker.gov.in
Authorization: Bearer 你的access_token

返回的响应里会有文档的原始数据，一般是Base64编码的PDF或图片。

三、存入数据库并返回成功响应 #

• 把拿到的文档数据（比如Base64内容、文档类型、关联的用户ID等）存入你的数据库，注意Aadhar这类敏感数据一定要加密存储。
• 数据库操作完成后，让你的回调接口返回HTTP 200状态码，响应体直接返回{"status": "success"}就行，这样整个流程就闭环了。

要是调用API时碰到具体错误，比如令牌过期、没权限拉取文档，可以对照DigiLocker的API错误码列表排查问题。

内容的提问来源于stack exchange，提问作者The_phoenix