Firebase Cloud Firestore能否使用HTTP GET/POST？咨询地址及参数

嘿，作为刚接触Firestore的新手，你的问题我当初入门时也琢磨过，这就给你详细拆解一下：

1. 能不能用HTTP GET/POST修改数据？ #

当然可以！Firestore提供了REST API，完全支持用HTTP方法来操作数据：

• GET：主要用于读取/查询数据（比如获取单个文档、查询集合内的文档）
• POST/PUT/PATCH：用于写入/修改数据（POST新增文档、PUT替换整个文档、PATCH更新部分字段）

不过要注意：GET本身是只读的，没法用来修改数据，修改得用POST/PUT/PATCH这类方法。

2. 请求地址怎么获取？ #

Firestore REST API的端点是固定格式的，你只需要替换对应的项目和数据路径占位符即可：

针对单个文档的端点 #

https://firestore.googleapis.com/v1/projects/{PROJECT_ID}/databases/(default)/documents/{COLLECTION_NAME}/{DOCUMENT_ID}

• {PROJECT_ID}：你的Firebase项目ID，在Firebase控制台「项目设置」里就能找到
• {COLLECTION_NAME}：你要操作的集合名称（比如users）
• {DOCUMENT_ID}：目标文档的ID（比如user123）

针对集合的端点（比如新增文档） #

https://firestore.googleapis.com/v1/projects/{PROJECT_ID}/databases/(default)/documents/{COLLECTION_NAME}

这个地址用来给集合添加新文档，Firestore会自动生成文档ID。

3. 请求需要填写哪些参数？ #

主要分为请求头和请求体两部分，还有URL上的查询参数（针对GET请求）：

必备请求头 #

不管是哪种操作，几乎都需要这两个请求头：

• Authorization: Bearer {AUTH_TOKEN}：必须的认证凭证，分两种情况：
  • 前端用户操作：用用户登录后的ID Token（通过Firebase Auth获取）
  • 后端/server操作：用服务账号生成的Token（可以用gcloud命令行或Firebase Admin SDK生成）
• Content-Type: application/json：POST/PUT/PATCH请求必须添加，因为请求体是JSON格式

不同操作的具体参数 #

读取数据（GET）

可以在URL后追加查询参数来过滤、排序、分页：

• 限制返回数量：?pageSize=10
• 按字段排序：?orderBy=age
• 过滤条件：?where=age%3D%3D25（注意==要URL编码成%3D%3D）
  示例请求地址：

https://firestore.googleapis.com/v1/projects/my-project/databases/(default)/documents/users?where=age%3D%3D25&pageSize=5

新增文档（POST）

请求体需要按Firestore的格式定义字段，示例：

{
  "fields": {
    "name": { "stringValue": "Alice" },
    "age": { "integerValue": 28 },
    "isActive": { "booleanValue": true }
  }
}

替换整个文档（PUT）

URL里要指定文档ID，请求体和POST类似，会完全覆盖原有文档：

{
  "fields": {
    "name": { "stringValue": "Alice Smith" },
    "age": { "integerValue": 29 },
    "isActive": { "booleanValue": false }
  }
}

更新部分字段（PATCH）

需要用updateMask指定要更新的字段，只修改指定内容：

{
  "fields": {
    "age": { "integerValue": 30 }
  },
  "updateMask": "age"
}

额外注意事项 #

• 安全规则：Firestore的安全规则会限制这些HTTP请求，要确保你的规则允许对应的操作（比如允许未认证用户读取，或者仅允许认证用户写入）
• 测试工具：可以用Postman、curl这类工具快速测试API，比如用curl发送POST请求：

curl -X POST \
  https://firestore.googleapis.com/v1/projects/my-project/databases/(default)/documents/users \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "name": { "stringValue": "Bob" }
    }
  }'

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