Plan Empresarial

Documentación de la API

La API REST de DinoQR permite crear, actualizar y gestionar códigos QR dinámicos desde cualquier sistema o lenguaje de programación. Solo disponible en el Plan Empresarial.

Autenticación

Genera tu API Key desde tu panel de DinoQR. Inclúyela en cada request de dos formas:

Opción A — Header (recomendado)

Authorization: Bearer TU_API_KEY

Opción B — Parámetro GET

/wp-json/dinoqr/v1/cuenta?api_key=TU_KEY

Base URL: https://dinoqr.me/wp-json/dinoqr/v1

Endpoints

Devuelve información de tu cuenta, plan activo y uso de QRs.

Respuesta

{
  "usuario":     "Mi Empresa",
  "correo":      "yo@miempresa.com",
  "plan":        "empresarial",
  "qrs_usados":  5,
  "qrs_max":     "ilimitado",
  "vencimiento": "2026-07-22"
}

{
  "total": 2,
  "qrs": [
    {
      "slug":        "ABC123",
      "nombre":      "Menú Restaurante",
      "url_destino": "https://mi-menu.com",
      "qr_url":      "https://dinoqr.me/q/ABC123",
      "imagen_url":  "https://dinoqr.me/qr-images/ABC123.png",
      "scans":       142,
      "activo":      true,
      "creado":      "2026-06-01 10:00:00"
    }
  ]
}

Parámetros

Parámetro	Tipo	Descripción
nombre requerido	string	Nombre descriptivo del QR
url_destino requerido	string	URL a la que redirige el QR (debe incluir https://)

Ejemplo

# curl
curl -X POST "https://dinoqr.me/wp-json/dinoqr/v1/qr/crear?api_key=TU_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Mi QR","url_destino":"https://google.com"}'

Respuesta

{
  "slug":        "XY9Z21",
  "nombre":      "Mi QR",
  "url_destino": "https://google.com",
  "qr_url":      "https://dinoqr.me/q/XY9Z21",
  "imagen_url":  "https://dinoqr.me/qr-images/XY9Z21.png",
  "scans":       0,
  "activo":      true
}

El QR físico no cambia — solo el destino al que redirige.

Parámetro	Tipo	Descripción
url_destino requerido	string	Nueva URL destino

# curl
curl -X PUT "https://dinoqr.me/wp-json/dinoqr/v1/qr/XY9Z21/url?api_key=TU_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url_destino":"https://nueva-url.com"}'

{
  "slug":        "XY9Z21",
  "total_scans": 142,
  "por_dia": [
    { "fecha": "2026-06-22", "total": 18 },
    { "fecha": "2026-06-21", "total": 24 }
  ],
  "paises": [
    { "pais": "México", "total": 98 },
    { "pais": "Estados Unidos", "total": 32 }
  ],
  "dispositivos": [
    { "dispositivo": "móvil",      "total": 118 },
    { "dispositivo": "escritorio", "total": 24 }
  ]
}

{
  "eliminado": true,
  "slug": "XY9Z21"
}

Códigos de error

Código	HTTP	Descripción
sin_auth	401	Falta la API Key
api_key_invalida	401	API Key incorrecta o expirada
plan_insuficiente	403	La API requiere plan Empresarial
limite_alcanzado	403	Alcanzaste el límite de QRs
no_encontrado	404	QR no encontrado o no te pertenece
datos_incompletos	400	Faltan parámetros requeridos
url_invalida	400	La URL no es válida

🚀

¿Listo para integrar DinoQR?

Activa el plan Empresarial y genera tu API Key desde tu panel.

Crear cuenta gratis