API REST

URL Base

http://localhost/survey-dashboard/api/index.php

Retorna todas las métricas: enviadas, respondidas, tasa de respuesta, promedio y distribución.

EJEMPLO DE RESPUESTA

{
  "success": true,
  "data": {
    "total_sent": 10,
    "total_responded": 7,
    "response_rate": 70.0,
    "average_rating": 4.14,
    "most_frequent_rating": 5,
    "rating_distribution": { "1": 0, "2": 1, "3": 1, "4": 2, "5": 3 },
    "monthly_stats": [...]
  }
}

Crea un nuevo registro de encuesta enviada. El status queda como sent.

{
  "title": "Encuesta de satisfacción",
  "recipient_name": "Ana García",     // required
  "recipient_email": "ana@demo.com",  // required
  "description": "Opcional..."
}

{
  "success": true,
  "message": "Survey created",
  "id": 11
}

curl -X POST http://localhost/survey-dashboard/api/index.php?endpoint=/surveys \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk-survey-demo-key-2024-abc123xyz" \
  -d '{"title":"Encuesta Q2","recipient_name":"Juan","recipient_email":"juan@test.com"}'

Registra la calificación de una encuesta. Actualiza automáticamente el status a responded.

{
  "survey_id": 11,       // required
  "rating": 5,           // required, 1-5
  "comment": "Excelente" // opcional
}

{
  "success": true,
  "message": "Response recorded"
}

Retorna el listado completo de encuestas con sus respuestas.

QUERY PARAMS