Documentación de la API

    Recursos y guías para desarrolladores para integrar QR Cake.

    API REST JSONCreación dinámica de QRAutorización Bearer

    Inicio rápido

    La API de QR Cake te permite gestionar los códigos QR de tu cuenta.

    Base URL
    https://api.qrcake.com/v1/product

    Autenticación

    Crea una clave API en tu panel y envíala en el encabezado Authorization.

    Authorization: Bearer <API Key>
    Content-Type: application/json

    Gestiona las claves API en Claves API del panel.

    Probador de solicitudes API

    Prueba los puntos finales directamente desde esta página. Introduce tu clave API, elige un punto final y revisa la respuesta en tiempo real.

    Probador interactivo de API

    Ejecuta solicitudes desde el navegador contra el punto final seleccionado de la API de QR Cake.

    GET
    Authorization: Bearer <API Key>
    URL resuelta
    https://api.qrcake.com/v1/product/user/product
    Ejecute una solicitud para ver el estado en vivo y el resultado de la respuesta aquí.

    Terminología

    Productos

    Códigos QR

    Usuarios

    Cuentas de QR Cake

    Cuerpos de solicitud (POST/PUT)

    Para las solicitudes POST y PUT, los cuerpos de la solicitud deben serializarse como cadena. Si vas a enviar JSON, pasa una cadena JSON (por ejemplo JSON.stringify(payload)).

    const payload = { redirect: "https://example.com", metadata: {} };
    
    await fetch(url, {
      method: "POST",
      body: JSON.stringify(payload),
    });
    GET

    Listar códigos QR

    Enumera los códigos QR accesibles con la clave API.

    Abrir en GitBook
    Ruta: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Detalles de la solicitud
    Encabezados
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Respuestas
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Productos = códigos QR.

    GET

    Obtener un código QR

    Obtiene un código QR.

    Abrir en GitBook
    Ruta: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Detalles de la solicitud
    Parámetros de ruta
    • productId (string)
    Encabezados
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Respuestas
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Crear un código QR

    Crea un nuevo código QR.

    Abrir en GitBook
    Ruta: /product
    URL: https://api.qrcake.com/v1/product/product
    Detalles de la solicitud
    Encabezados
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Plantilla de cuerpo
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Respuestas
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    El cuerpo de la solicitud POST debe enviarse serializado (por ejemplo, JSON.stringify(payload)).

    PUT

    Actualizar un código QR

    Actualiza un código QR existente.

    Abrir en GitBook
    Ruta: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Detalles de la solicitud
    Parámetros de ruta
    • productId (string)
    Encabezados
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Plantilla de cuerpo
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Respuestas
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    El cuerpo de la solicitud PUT debe enviarse serializado.

    DELETE

    Eliminar un código QR

    Elimina un código QR.

    Abrir en GitBook
    Ruta: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Detalles de la solicitud
    Parámetros de ruta
    • productId (string)
    Encabezados
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Respuestas
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Permisos

    Devuelve los permisos otorgados a la clave API.

    Abrir en GitBook
    Ruta: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Detalles de la solicitud
    Encabezados
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Respuestas
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Tipos de QR admitidos

    Usa estos tipos de metadatos al crear o actualizar códigos QR.

    redirect, link, image, video, file, pdf, audio, app, event, vCard

    Empieza con códigos QR dinámicos y códigos QR editables en nuestra página principal.