Sistema de Promociones y Sorteos Para Wordpress

Propósito: Consultar premios disponibles de una campaña y realizar sorteo automático

Ejemplo de Petición:

GET https://promosbienvenida.bingopilar.com.ar//api/v1/premios/7d5eb58d07

✅ Respuesta Exitosa (200):

{
  "id_premio": "324",
  "premio": "TICKET 15.000",
  "qr_accion_web": "MGTLRJNNVY",
  "status_code": 200
}

❌ Error - Código de campaña inválido (400):

{
  "error": "El codigo campana no existe en params"
}

❌ Error - Sin premios disponibles (404):

{
  "error": "No hay premios disponibles para esta campaña",
  "status_code": 404
}

❌ Error del servidor (500):

{
  "error": "Error al realizar el sorteo",
  "status_code": 500
}

Propósito: Registrar participación de un usuario y enviar email con premio

Ejemplo de Petición:

POST https://promosbienvenida.bingopilar.com.ar//api/v1/acciones/insertar-wordpress
Content-Type: application/json

{
  "nombre_apellido": "Juan Pérez",
  "email": "juan@example.com",
  "celular": "1123456789",
  "id_premio": "324"
}

✅ Respuesta Exitosa - Email nuevo (200):

El usuario participó por primera vez. Se registra, sortea premio y envía email.

{
  "message": "Acción registrada correctamente",
  "status_code": 200,
  "data": {
    "nombre": "Juan Pérez",
    "imagen_qr": "MGTLY3G3S4",
    "codigo_qr": "MGTLY3G3S4",
    "premio": "TICKET 15.000",
    "fecha_vigencia": "16/10/2025",
    "dias_vigencia_reclamo": 7,
    "email": "juan@example.com",
    "IMG_LOGO": "https://bingopilar.com.ar/...",
    "URL_QR": "https://atc.bingopilar.com.ar/...",
    "URL_MAPS": "https://maps.app.goo.gl/...",
    "DIRECCION": "PANAMERICANA KM 50.4"
  }
}

❌ Error - Email ya registrado (403):

El usuario ya participó anteriormente con este email.

{
  "error": "Email ya cargado anteriormente"
}

❌ Error - Campos faltantes (400):

{
  "error": "Falta el campo requerido: email"
}

❌ Error - Email inválido (400):

{
  "error": "Formato de correo electrónico inválido"
}

❌ Error del servidor (500):

{
  "error": "Error interno del servidor"
}

📋 Campos Obligatorios:

• nombre_apellido: Nombre completo del participante.
  Si no se dispone del nombre, se puede generar automáticamente usando la parte anterior al @ del email. Ejemplo: para juangomez@gmail.com el campo será "juangomez".
• email: Email único del participante.
  El sistema valida que este email no haya sido utilizado previamente en la campaña (anti-fraude).
• celular: Número de teléfono del participante.
  Este campo es opcional y puede enviarse vacío ("celular": "") si no se dispone del dato.
• id_premio: ID del premio sorteado.
  Este valor se obtiene previamente consultando el endpoint GET de premios disponibles.