Skip to main content

使用 ActRight API 构建应用

通过现代 REST API 访问请愿、签名、评论等内容。几分钟内即可上线集成。

环境生产环境https://api.actright.com

快速开始

以你偏好的语言获取请愿。

请求
curl -s https://api.actright.com/v1/petitions?limit=5 \
  -H "Authorization: Bearer YOUR_API_KEY" | jq .
响应
{
  "data": [
    {
      "id": "pet_abc123",
      "title": "Save the Local Park",
      "slug": "save-the-local-park",
      "signatureCount": 1248,
      "goal": 5000,
      "status": "active"
    }
  ],
  "meta": { "total": 42, "page": 1, "limit": 5 }
}

身份验证

所有 API 请求都需要在 Authorization 请求头中提供 Bearer 令牌。

Authorization: Bearer gsk_your_api_key_here

API 密钥权限范围:可以创建具有 readread_writefull 访问权限的密钥。请为你的使用场景选择权限最小的范围。

速率限制

API 请求受速率限制,以确保公平使用。

1,000
每小时请求数(未认证)
5,000
每小时请求数(已认证)

每个响应中都包含速率限制请求头:X-RateLimit-IP-LimitX-RateLimit-IP-RemainingX-RateLimit-IP-Reset。使用 API 密钥的请求采用各自的等级限制。

API 演练场

直接在浏览器中试用 API 端点。无需任何设置。

API Playground

实时
https://api.actright.com/v1/petitions

资源

使用 ActRight 构建所需的一切。

保持关注

跟踪 API 变更并监控服务健康状况。