SparkGlim Desarrolladores
Dar a tu asistente el contexto correcto.

Prepara una instrucción con documentación verificada. Elige producto, tecnología y asistente; copia o descarga la guía pública.
Elige tu producto API
Elige tu entorno tecnológico
Elige tu asistente
Campañas públicas y participación

Mostrar campañas públicas permitidas y conectar su participación compatible.
Requisitos previos: Usa solo registros públicos y reglas exactas de cada operación.
Alcance verificado y límites: Los datos públicos no incluyen compradores, donantes, cuentas privadas ni campañas sin publicar.
# SparkGlim — Campañas públicas y participación

Ayúdame a implementar una integración SparkGlim solo con las fuentes públicas verificadas siguientes. Mantén el producto API elegido separado de los demás modelos de acceso.

Elige tu entorno tecnológico: TypeScript
Elige tu asistente: Codex
Idioma de documentación: es

## Experiencia prevista

Mostrar campañas públicas permitidas y conectar su participación compatible.

## Requisitos previos

Usa solo registros públicos y reglas exactas de cada operación.

## Arquitectura y límites de confianza

Usa el lenguaje elegido para HTTP en el servidor y mantén allí la autenticación privada. No inventes SDK oficiales ni comandos de instalación.

Usa el asistente como ayuda de desarrollo. Explica cambios propuestos y mantén las fuentes públicas por encima de sugerencias generadas.

## Autenticación y permisos

El acceso depende de cuenta, dominios, permisos, miembros y visibilidad. Elegir país o idioma no activa pagos ni cambia la moneda.

## Operaciones verificadas para esta guía

Solo aparecen operaciones implementadas y verificadas. Se excluyen las no verificadas o retiradas; no sustituyas capacidades ausentes por rutas privadas.

Los campos, tipos y validación son requisitos del protocolo, no registros de clientes.

### GET /api/public/payment-methods/:campaignId — Opciones de pago de campaña

Lista métodos activos para país vendedor, moneda y cliente de campaña aprobada sin secretos.

Modelo de acceso: API pública

Contrato de solicitud:
- campaignId (path; string; Obligatorio): Campaña existente dentro de la cuenta y del alcance más limitado de la credencial. Validación: UUID o identificador de recurso documentado.
- app_type (query; enum; Opcional): Contexto existente para elegir configuración web o app; sin permisos extra. Validación: user_app si lo selecciona el usuario; en otro caso web.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":{"methods":["item"],"currency":"string","country":"string"}}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.
Abra la URL de pago devuelta. SparkGlim Server controla precios, métodos, verificación y entrega; el retorno del navegador solo navega.

https://developer.sparkglim.net/reference/public/public-get-api-public-payment-methods-campaignId?lang=es

### GET /api/public/tickets/public-verify — Verificación pública de entradas

Reenvía verificación de credencial al lector web y conserva estado y resultado; no registra admisión.

Modelo de acceso: API pública

Contrato de solicitud:
- code (query; string; Obligatorio): Credencial o código requerido; nunca publique OTP real o secreto de entrada. Validación: Credencial de entrada válida.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":{"ticket_code":"string","checked_in":"boolean","checked_in_at":"null","details_revealed":"boolean","campaign":{"title":"string","slug":"string","venue":"string"},"ticket_name":"string"}}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.
Abra la URL de pago devuelta. SparkGlim Server controla precios, métodos, verificación y entrega; el retorno del navegador solo navega.
Trate códigos como credenciales. Puede mostrar datos tras el registro; la verificación no lo autoriza.

https://developer.sparkglim.net/reference/public/public-get-api-public-tickets-public-verify?lang=es

### GET /api/public/blog — Artículos publicados

Lista artículos publicados con búsqueda, categoría, destacados y paginación exacta.

Modelo de acceso: API pública

Contrato de solicitud:
- category (query; string; Opcional): Categoría de campaña o configuración aprobada según recurso. Validación: Identificador de categoría en la URL.
- search (query; string; Opcional): Filtro textual aplicado a registros publicados seleccionados. Validación: Texto de búsqueda.
- featured (query; string; Opcional): Activa filtro de artículos destacados con valor true. Validación: true.
- limit (query; number; Opcional): Máximo de registros en la página; se aplica el límite fijo del endpoint. Validación: 1–30; valor predeterminado: 10.
- offset (query; number; Opcional): Número de artículos publicados a omitir antes de página, desde cero. Validación: >=0; valor predeterminado: 0.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":["item"],"count":"number","limit":"number","offset":"number"}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.
Abra la URL de pago devuelta. SparkGlim Server controla precios, métodos, verificación y entrega; el retorno del navegador solo navega.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog?lang=es

### GET /api/public/blog/categories — Categorías de artículos

Lista categorías activas por posición configurada y número de artículos.

Modelo de acceso: API pública

Contrato de solicitud:
Sin campos documentados.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":["item"]}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.
Abra la URL de pago devuelta. SparkGlim Server controla precios, métodos, verificación y entrega; el retorno del navegador solo navega.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-categories?lang=es

### GET /api/public/blog/:slug — Detalle de artículo publicado

Devuelve artículo publicado y hasta cuatro relacionados, e incrementa su contador de vistas.

Modelo de acceso: API pública

Contrato de solicitud:
- slug (path; string; Obligatorio): Identificador de URL para campaña o artículo publicado existente. Validación: Identificador URL público.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":{"post":{"id":"string","slug":"string","title":"string","status":"string"},"relatedPosts":["item"]}}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.
Abra la URL de pago devuelta. SparkGlim Server controla precios, métodos, verificación y entrega; el retorno del navegador solo navega.
Leer un artículo incrementa sus vistas. Este GET no es una inspección sin cambios.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-slug?lang=es

### GET /api/public/homepage/discovery — Descubrimiento de campañas públicas

Busca índice público estricto por producto, país, período, lugar y fecha; devuelve paginación exacta y datos permitidos.

Modelo de acceso: API pública

Contrato de solicitud:
- q (query; string; Opcional): Texto buscado en título, descripción, organizador, ubicación o beneficiario públicos. Validación: <=100.
- country (query; string; Opcional): Filtro por país configurado de campaña; no habilita pagos ni convierte moneda. Validación: ISO2.
- location (query; string; Opcional): Ubicación pública o filtro; separado del país vendedor financiero. Validación: <=100.
- type (query; enum; Opcional): Tipo de recurso, reacción o filtro de campaña admitido aquí. Validación: all | ticketing | voting | donation.
- status (query; enum; Opcional): Estado admitido solicitado; aprobación controla publicación y acceso. Validación: all | active | upcoming | ended | postponed.
- sort (query; enum; Opcional): Selecciona orden del servidor: destacados, recientes o cierre. Validación: featured | latest | ending.
- date (query; enum; Opcional): Limita búsqueda a ventana de fecha documentada del filtro existente. Validación: all | today | tomorrow | weekend | month.
- page (query; integer; Opcional): Página solicitada según numeración documentada; conserve metadatos del servidor. Validación: 1–1000000.
- limit (query; integer; Opcional): Máximo de registros en la página; se aplica el límite fijo del endpoint. Validación: 1–24; valor predeterminado: 12.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":{"entries":["item"],"countries":["item"],"locations":["item"],"pagination":{"page":"number","limit":"number","total":"number","pages":"number","hasMore":"boolean"},"available":"boolean"}}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.
Devuelva solo registros permitidos por cuenta, campaña y visibilidad.

https://developer.sparkglim.net/reference/public/public-get-api-public-homepage-discovery?lang=es

### GET /api/public/homepage/campaigns — Campañas de inicio

Devuelve hasta72 campañas públicas activas de un país opcional; no es índice completo paginado.

Modelo de acceso: API pública

Contrato de solicitud:
- country (query; string; Opcional): Filtro por país configurado de campaña; no habilita pagos ni convierte moneda. Validación: ISO2.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":{"campaigns":["item"],"countries":["item"],"available":"boolean"}}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.
Campañas públicas activas, máximo72, sin paginación.

https://developer.sparkglim.net/reference/public/public-get-api-public-homepage-campaigns?lang=es

### GET /api/public/homepage/awards — Campañas públicas de premios

Devuelve hasta200 campañas públicas aprobadas, terminadas o aplazadas, por destacado y creación.

Modelo de acceso: API pública

Contrato de solicitud:
- country (query; string; Opcional): Filtro por país configurado de campaña; no habilita pagos ni convierte moneda. Validación: ISO2.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":{"campaigns":["item"],"countries":["item"],"available":"boolean"}}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.
Solo votación, máximo200, sin paginación.

https://developer.sparkglim.net/reference/public/public-get-api-public-homepage-awards?lang=es

### GET /api/public/countries — Catálogo de países activos

Devuelve catálogo activo de países y monedas predeterminadas; no lista corredores de pago habilitados.

Modelo de acceso: API pública

Contrato de solicitud:
Sin campos documentados.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":[{"code":"string","name":"string","phoneCode":"string","isDefault":"boolean","currency":"object"}]}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.
El catálogo no activa pagos ni dominios nacionales.

https://developer.sparkglim.net/reference/public/public-get-api-public-countries?lang=es

### GET /api/public/blog/:slug/reactions — Leer reacciones

Cuenta reacciones del artículo publicado y selecciones actuales sin devolver identidades ajenas.

Modelo de acceso: API pública

Contrato de solicitud:
- slug (path; string; Obligatorio): Identificador de URL para campaña o artículo publicado existente. Validación: Identificador URL público.
- visitorId (query; string; Opcional): Identidad del visitante usada para consultar o alternar su reacción. Validación: Identidad del visitante.
- profileToken (query; string; Opcional): Token de perfil comunitario verificado existente; este endpoint no crea identidad. Validación: Perfil de comunidad existente y verificado.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":{"counts":{"like":"number","love":"number","insightful":"number","celebrate":"number","clap":"number"},"mine":["item"]}}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-slug-reactions?lang=es

### GET /api/public/blog/:slug/comments — Comentarios aprobados

Lista hasta500 comentarios aprobados de antiguos a nuevos sin contacto privado del autor.

Modelo de acceso: API pública

Contrato de solicitud:
- slug (path; string; Obligatorio): Identificador de URL para campaña o artículo publicado existente. Validación: Identificador URL público.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":["item"]}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.
Hasta500 comentarios aprobados, antiguos primero, sin paginación.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-slug-comments?lang=es

### GET /api/public/qr/ticket/:code — Imagen QR de entrada

Devuelve PNG de marca de tamaño limitado para credencial; renderizar no concede propiedad.

Modelo de acceso: API pública

Contrato de solicitud:
- code (path; string; Obligatorio): Credencial o código requerido; nunca publique OTP real o secreto de entrada. Validación: UUID o identificador de recurso documentado.
- size (query; integer; Opcional): Anchura de imagen QR limitada por renderizador existente. Validación: 128–1024; valor predeterminado: 512.

Estado HTTP correcto: 200

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Disponibilidad verificada en el código, sin garantía de producción.
Respuesta PNG binaria, no JSON. Mostrar un código no autoriza el registro.

https://developer.sparkglim.net/reference/public/public-get-api-public-qr-ticket-code?lang=es

### GET /api/participants/search — Búsqueda pública por código

Busca candidato aprobado o campaña pública por código o slug según visibilidad y categoría activa.

Modelo de acceso: API pública

Contrato de solicitud:
- code (query; string; Obligatorio): Credencial o código requerido; nunca publique OTP real o secreto de entrada. Validación: Código de candidato, participante o campaña, o identificador URL de campaña; se acepta q como alias.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","resultType":"string","participant":{"id":"string","name":"string","bio":"null","category":"null","vote_count":"null","show_vote_count":"boolean","participant_code":"string","nominee_code":"null","image_url":"null"},"campaign":{"id":"string","title":"string","slug":"string","status":"string","campaign_type":"string","vote_price":"number","image_url":"null","banner_url":"null"}}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Este controlador web no define limitador propio; pueden existir controles previos.

Disponibilidad verificada en el código, sin garantía de producción.
Devuelva solo registros permitidos por cuenta, campaña y visibilidad.

https://developer.sparkglim.net/reference/public/public-get-api-participants-search?lang=es

### GET /api/public/voting-counts/:campaignId — Totales públicos según visibilidad

Devuelve votos completados solo para campaña pública, candidatos aprobados y categorías activas con totales públicos explícitos.

Modelo de acceso: API pública

Contrato de solicitud:
- campaignId (path; string; Obligatorio): Campaña existente dentro de la cuenta y del alcance más limitado de la credencial. Validación: UUID o identificador de recurso documentado.

Estado HTTP correcto: 200
Contrato de respuesta esperado: {"success":"boolean","data":{"visible":"boolean","voteCounts":{}}}

Validación y recuperación: Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Este controlador web no define limitador propio; pueden existir controles previos.

Disponibilidad verificada en el código, sin garantía de producción.
Devuelva solo registros permitidos por cuenta, campaña y visibilidad.

https://developer.sparkglim.net/reference/public/public-get-api-public-voting-counts-campaignId?lang=es

## Gestión de credenciales y solicitudes

Nunca añadas claves reales, sesiones, URL privadas, contactos, OTP ni campañas sin publicar. Usa marcadores y pide contexto sin secretos.

## Validación y recuperación

Valida según el esquema. Conserva referencias y claves de idempotencia, usa nonces nuevos y no repitas errores de validación o permisos sin cambios.

## Transferencia al pago centralizado

Para participación de pago, crea la sesión compatible en el servidor y abre su URL checkout.sparkglim.net. SparkGlim Server controla proveedor, verificación y entrega. No añadas verificación ni sondeo del pago en el navegador.

## Alcance verificado y límites

Los datos públicos no incluyen compradores, donantes, cuentas privadas ni campañas sin publicar.

La implementación en el código no demuestra disponibilidad en producción. Revisa el estado actual de la API y el origen documentado antes de usar una operación. Si la API necesaria no está disponible, detente y pide el siguiente paso aprobado; no inventes alternativas ni llames a una API privada del panel.

## Fuentes públicas oficiales

- https://developer.sparkglim.net/public-api?lang=es
- https://developer.sparkglim.net/responses?lang=es
- https://developer.sparkglim.net/security?lang=es
- https://developer.sparkglim.net/api-status?lang=es

## Instrucciones que conservar en el repositorio

Lee las instrucciones del proyecto. Reutiliza componentes y transportes, conserva trabajo ajeno y propone pruebas específicas. No ejecutes pagos, cambios de cuenta ni mensajes reales sin autorización.

Explica la arquitectura, enumera operaciones documentadas exactas y propone un plan mínimo de servidor y cliente. Señala capacidades no disponibles y pide contexto sin solicitar secretos.
Copia esta guía en tu asistente o añade el archivo al proyecto. Elegir un asistente no conecta cuentas ni envía instrucciones.
Usa solo documentación pública y marcadores. No incluyas credenciales, información de clientes ni datos privados de campañas en las instrucciones.
Campañas públicas y participación

Seguir desarrollando
