Documentación

Documentación técnica y guías de integración

Todo lo que necesitas para integrar Valqor en tu stack.

Primeros pasos

Crea tu primer enlace de marca, configura un dominio personalizado y explora el panel.

Regístrate y crea tu espacio de trabajo
Añade un dominio propio en Panel → Dominios
Crea tu primer enlace con un slug de marca
Consulta la analítica en tiempo real en tu panel

Referencia API

API REST para enlaces, dominios, analíticas y gestión de claves API con permisos por scope.

Autenticación

Genera una clave API en Panel → Claves API. Inclúyela como token Bearer:

Authorization: Bearer vq_your_key_here

Integraciones

Conecta Valqor a tu CRM, pipelines CI/CD, plataformas de marketing y herramientas de analítica.

Webhooks — Notificaciones de eventos en tiempo real (solo HTTPS)
Importación y exportación CSV — Gestión masiva de enlaces
Seguimiento de conversiones — Atribución basada en píxel
GA4 — Etiquetado automático con parámetros UTM

REST API

Endpoints de la API

URL base: https://valqor.app

POST/api/links

Crea un nuevo enlace de marca

Ejemplo

curl -X POST https://valqor.app/api/links \
  -H "Authorization: Bearer vq_..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "go.example.com",
    "slug": "launch",
    "destination": "https://example.com/product",
    "tags": ["marketing", "launch-2025"]
  }'

GET/api/links

Lista todos los enlaces de tu espacio de trabajo

Ejemplo

curl https://valqor.app/api/links \
  -H "Authorization: Bearer vq_..."

PATCH/api/links/:id

Actualiza un enlace existente

Ejemplo

curl -X PATCH https://valqor.app/api/links/lnk_abc123 \
  -H "Authorization: Bearer vq_..." \
  -H "Content-Type: application/json" \
  -d '{ "destination": "https://example.com/new-page" }'

DELETE/api/links/:id

Elimina un enlace de forma permanente

Ejemplo

curl -X DELETE https://valqor.app/api/links/lnk_abc123 \
  -H "Authorization: Bearer vq_..."

GET/api/analytics

Obtiene la analítica de tus enlaces

Ejemplo

curl "https://valqor.app/api/analytics?period=30d" \
  -H "Authorization: Bearer vq_..."

GET/api/domains

Lista los dominios propios configurados

Ejemplo

curl https://valqor.app/api/domains \
  -H "Authorization: Bearer vq_..."

Límites

Límites de peticiones

Los límites de peticiones de la API se aplican por clave API con una ventana deslizante.

Free60 req/min

Pro600 req/min

Business6 000 req/min

Convenciones

Formato de respuesta

Éxito

{
  "item": { "id": "lnk_abc123", "slug": "launch", ... }
}

Error

{
  "error": "Slug is already taken",
  "code": "SLUG_COLLISION"
}

Ir al panel