Documentación de la API
Recursos y guías para desarrolladores para integrar QR Cake.
Inicio rápido
La API de QR Cake te permite gestionar los códigos QR de tu cuenta.
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.
Authorization: Bearer <API Key>https://api.qrcake.com/v1/product/user/product
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),
});Listar códigos QR
Enumera los códigos QR accesibles con la clave API.
Authorization: Bearer <API Key>Accept: application/json
[
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}
]{
"message": {}
}Productos = códigos QR.
Obtener un código QR
Obtiene un código QR.
- productId (string)
Authorization: Bearer <API Key>Accept: application/json
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}Crear un código QR
Crea un nuevo código QR.
Authorization: Bearer <API Key>Content-Type: application/jsonAccept: application/json
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}El cuerpo de la solicitud POST debe enviarse serializado (por ejemplo, JSON.stringify(payload)).
Actualizar un código QR
Actualiza un código QR existente.
- productId (string)
Authorization: Bearer <API Key>Content-Type: application/jsonAccept: application/json
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"expiresAt": 0,
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}El cuerpo de la solicitud PUT debe enviarse serializado.
Eliminar un código QR
Elimina un código QR.
- productId (string)
Authorization: Bearer <API Key>Accept: application/json
{
"productId": "string"
}{
"message": {}
}Permisos
Devuelve los permisos otorgados a la clave API.
Authorization: Bearer <API Key>Accept: application/json
{
"success": true,
"result": {
"analytics": true,
"productLimit": 100,
"tier": "subscriber",
"productTotal": 3,
"productActiveLimit": 100,
"productActiveTotal": 3
}
}{
"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.