Ir a la documentación
SparkGlimDeveloper
Centro de integración con IA
SparkGlimSparkGlim Desarrolladores
Buscar en toda la documentación

Prueba un tema en tu idioma o una ruta API exacta.

    Navegación de documentación

    Referencia API

    Estado público de entrada

    Lee estado público de admisión del tenant sin registrar entrada ni exponer QR comprado.

    POSThttps://api.sparkglim.net/api/white-label/v1/tickets/verify

    Modelo de acceso

    Modelo de acceso
    Dominio verificado y clave pública limitada
    Permiso requerido
    tickets:read
    Disponibilidad documentada
    Implementado en código

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

    La firma privada permanece en su servidor. La API Versión 1 usa firma v2; no es una API v2.

    Encabezados

    NombreTipoValidación
    x-white-label-domainObligatorio

    Dominio verificado que resuelve la cuenta de Organización aprobada y vincula esta solicitud.

    		stringValidación: Nombre de host HTTPS verificado.
    x-white-label-keyObligatorio

    Clave pública o de campaña completa para el alcance de lectura segura permitido.

    		stringValidación: Clave pública o de campaña emitida con formato keyId:secret.

    Solicitud

    NombreTipoValidación
    campaignIdObligatorio

    Campaña existente dentro de la cuenta y del alcance más limitado de la credencial.

    		stringValidación: UUID obligatorio para buscar una entrada dentro del ámbito autorizado.
    ticketCodeObligatorio

    Credencial de entrada existente en campaña autorizada para consulta o admisión.

    		stringValidación: Credencial de entrada; 3–120.

    Solicitud

    Los ejemplos describen el contrato y no se ejecutan. Use registros de prueba autorizados; nunca pegue secretos reales aquí.

    POST /api/white-label/v1/tickets/verify
    http
    POST /api/white-label/v1/tickets/verify HTTP/1.1
Host: api.sparkglim.net
x-white-label-domain: events.example.com
x-white-label-key: <ISSUED_PUBLIC_OR_CAMPAIGN_KEY>
Content-Type: application/json

{
  "campaignId": "11111111-1111-4111-8111-111111111111",
  "ticketCode": "<EXISTING_TICKET_CODE>"
}

    Respuesta

    Respuesta correcta · HTTP 200
    json
    {
  "success": true,
  "data": {
    "status": "invalid",
    "message": "This ticket code is invalid."
  },
  "requestId": "wlapi_example"
}
    Respuesta de error · HTTP 400
    json
    {
  "success": false,
  "error": "<ERROR_MESSAGE>",
  "requestId": "wlapi_example"
}

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

    Límites y reintentos

    Organización: 120 solicitudes por clave y 300 por IP por ventana; respete Retry-After y X-RateLimit.

    Compatibilidad del código

    Las operaciones autorizadas requieren pruebas específicas de la cuenta.

    • server/src/api/router.ts
    • server/src/api/routes/white-label.ts
    • server/src/white-label/auth.ts
    • server/src/white-label/schemas.ts
    • server/src/white-label/organization-service.ts
    • server/src/white-label/service.ts

    Seguir desarrollando