Einreichungen-API
Erstellen und rufen Sie Feedback-Einreichungen programmatisch ab.
Einreichungen auflistenโ
GET /api/v2/submissions
Query-Parameterโ
| Parameter | Typ | Beschreibung |
|---|---|---|
page | integer | Seitennummer (Standard: 1) |
per_page | integer | Eintrรคge pro Seite (Standard: 15, max: 100) |
status | string | Nach Status filtern: pending, approved, resolved, spam |
campaign_id | integer | Nach Kampagnen-ID filtern |
product_id | integer | Nach Produkt-ID filtern |
from | date | Startdatum (JJJJ-MM-TT) |
to | date | Enddatum (JJJJ-MM-TT) |
Beispielโ
curl "https://yourdomain.com/api/v2/submissions?status=approved&per_page=10" \
-H "Authorization: Bearer YOUR_API_KEY"
Antwortโ
{
"data": [
{
"id": 42,
"campaign_id": 1,
"product_id": 1,
"star_rating": 5,
"nps_score": 9,
"text_feedback": "Absolutely love this product!",
"customer_name": "Jane Doe",
"customer_email": "[email protected]",
"sentiment_score": 0.92,
"sentiment_label": "positive",
"status": "approved",
"is_public": true,
"admin_reply": "Thank you, Jane! We're glad you love it.",
"created_at": "2024-03-15T10:30:00Z"
}
],
"meta": {
"current_page": 1,
"per_page": 10,
"total": 42
}
}
Einzelne Einreichung abrufenโ
GET /api/v2/submissions/{id}
Beispielโ
curl "https://yourdomain.com/api/v2/submissions/42" \
-H "Authorization: Bearer YOUR_API_KEY"
Einreichung erstellenโ
POST /api/v2/submissions
Anfrage-Bodyโ
{
"campaign_id": 1,
"star_rating": 5,
"nps_score": 9,
"text_feedback": "Great product, very intuitive!",
"customer_name": "John Smith",
"customer_email": "[email protected]"
}
Parameterโ
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
campaign_id | integer | Ja | Kampagne, an die eingereicht wird |
star_rating | integer | Nein | 1โ5 Sternebewertung |
nps_score | integer | Nein | 0โ10 NPS-Wert |
text_feedback | string | Nein | Freitext-Feedback |
customer_name | string | Nein | Name des Einreichers |
customer_email | string | Nein | E-Mail des Einreichers |
survey_responses | object | Nein | Antworten auf benutzerdefinierte Survey-Felder |
Antwort (201 Created)โ
{
"data": {
"id": 43,
"campaign_id": 1,
"star_rating": 5,
"status": "pending",
"created_at": "2024-03-15T11:00:00Z"
},
"message": "Submission created successfully"
}