Seznam odpovědí

Name: SentiSnap
Author: SentiSnap s.r.o.

Získejte odpovědi z průzkumu s volitelným filtrováním.

GET

https://api.sentisnap.com/v1/surveys/{surveyId}/responses

Autentizace

Vyžaduje API klíč s oprávněním responses:read.

Path parametry

Parametr	Typ	Povinný	Popis
`surveyId`	string	Ano	Survey UUID

Query parametry

Parametr	Typ	Povinný	Popis
`page`	integer	Ne	Page number (default: 1)
`per_page`	integer	Ne	Number per page (default: 50, max: 100)
`filter[submittedAt][gte]`	string	Ne	Filter by date (ISO 8601)
`filter[submittedAt][lte]`	string	Ne	Filter by date (ISO 8601)

Odpověď

{
  "data": [
    {
      "id": "019def45-6789-0abc-def0-123456789abc",
      "respondent_id": "resp_abc123",
      "status": "completed",
      "data": {
        "question_uuid_1": "Very satisfied",
        "question_uuid_2": [
          "Feature A",
          "Feature C"
        ],
        "question_uuid_3": "The product is excellent and easy to use."
      },
      "metadata": {
        "source": "email",
        "language": "en",
        "time_spent_seconds": 245
      },
      "started_at": "2024-01-20T14:20:00Z",
      "submitted_at": "2024-01-20T14:24:05Z",
      "created_at": "2024-01-20T14:20:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 1250,
    "total_pages": 25
  },
  "links": {
    "self": "/v1/surveys/019abc.../responses?page=1",
    "next": "/v1/surveys/019abc.../responses?page=2"
  }
}

Pole odpovědi

Pole	Typ	Popis
`id`	string	Unikátní identifikátor odpovědi
`respondent_id`	string	Anonymní identifikátor respondenta
`status`	string	Stav odpovědi: started, completed
`data`	object	Odpovědi na otázky klíčované podle ID otázky
`metadata`	object	Další metadata odpovědi
`started_at`	string	Kdy respondent začal
`submitted_at`	string	Kdy byla odpověď odeslána

Příklad

# Get responses from the last 7 days
curl -X GET "https://public-api.sentisnap.com/v1/surveys/019abc.../responses?filter[submittedAt][gte]=2024-01-13T00:00:00Z" \
  -H "Authorization: Bearer sk_live_..."

Chyby

Kód	Popis
`401`	Neplatný API klíč
`403`	Nedostatečné oprávnění (vyžaduje `responses:read`)
`404`	Průzkum nenalezen