REST API v2 Overview

FeedbackPulse SaaS provides a RESTful API (v2) for programmatic access to your tenant data. Use it to integrate feedback into your own apps, build dashboards, or automate workflows.

---

Base URL

https://yourdomain.com/api/v2

---

Authentication

All API requests require a Bearer token (API key):

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://yourdomain.com/api/v2/submissions

Getting an API Key

1. 登录 to your 租户仪表板
2. 前往 设置 > API Keys
3. Click Create API Key
4. Copy the key immediately (it's only shown once!)

API 密钥 are stored as SHA256 hashes. The raw key cannot be recovered.

Plan requirement: API access requires the api_access feature flag on your plan.

---

Rate Limiting

Limit	值
Requests per minute per tenant	60

Rate limit headers are included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57

---

Available Endpoints

方法	端点	说明
GET	/api/v2/submissions	List submissions
GET	/api/v2/submissions/{id}	Get single submission
POST	/api/v2/submissions	Create a submission
GET	/api/v2/products	List products
POST	/api/v2/products	Create a product
GET	/api/v2/campaigns	List campaigns
POST	/api/v2/campaigns	Create a campaign
GET	/api/v2/webhooks/config	Get webhook configuration
PUT	/api/v2/webhooks/config	Update webhook configuration
GET	/api/v2/webhooks/logs	View webhook delivery logs

---

Response Format

All responses are JSON:

{
  "data": [...],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 42
  }
}

Error Responses

{
  "error": "Unauthenticated.",
  "status": 401
}

Status Code	Meaning
200	Success
201	Created
400	Bad Request (validation error)
401	Unauthorized (invalid/missing API key)
403	Forbidden (insufficient permissions)
404	Not Found
429	Too Many Requests (rate limited)
500	Server Error

---

Deep Dive

• Authentication -- API key details
• 提交 API -- create and list feedback
• 产品 API -- manage products
• 活动 API -- manage campaigns
• Webhooks -- real-time event notifications