Docs: herramientas

Acortador de enlaces, códigos QR y texto oculto cifrado

Herramientas PRODUCCION 🧪 Mocks disponibles — usa una key Sandbox para probar sin costo

Documentación

Herramientas URL

Acorta enlaces, genera QR y oculta texto cifrado.

POST /call/url-tools/1.0.0/acortar desde $1.00 MXN/petición

Parámetros

Nombre	Ubicación	Tipo	Requerido	Descripción
Url	BODY	STRING	Sí	URL de destino. Debe iniciar con http:// o https://
Descripcion	BODY	STRING	No	Nota interna para identificar el enlace
MaxUsos	BODY	INTEGER	No	Clics maximos. Ausente o 0 = sin limite
Dias	BODY	INTEGER	No	Vigencia en dias desde la creacion (se recorta a 3650). Ausente o 0 = sin caducidad
Expira	BODY	STRING	No	Caducidad exacta ISO-8601 (2026-12-31 o 2026-12-31T23:59:00). Una fecha sin hora vence al final de ese dia. Gana sobre Dias
Permanente	BODY	BOOLEAN	No	true ignora MaxUsos, Dias y Expira
PaisesPermitidos	BODY	ARRAY	No	Codigos ISO-2 de los paises que pueden abrirlo. Vacio = todos
IPsPermitidas	BODY	ARRAY	No	IPs o CIDR que pueden abrirlo. Vacio = todas
IPsBloqueadas	BODY	ARRAY	No	IPs o CIDR que NO pueden abrirlo. Gana sobre las permitidas

Ejemplos de código

curl -X POST \
  "/call/url-tools/1.0.0/acortar" \
  -H "X-Api-Key: YOUR_PREFIX.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"param": "valor"}'

import requests

url = "/call/url-tools/1.0.0/acortar"
headers = {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
}
payload = {"param": "valor"}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code, response.json())

const response = await fetch("/call/url-tools/1.0.0/acortar", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"param": "valor"}),
});
const data = await response.json();
console.log(data);

POST /call/url-tools/1.0.0/eliminar desde $1.00 MXN/petición

Parámetros

Nombre	Ubicación	Tipo	Requerido	Descripción
Id	BODY	INTEGER	No	Id del recurso, tal como viene en /listar. Requerido si no mandas Codigo
Codigo	BODY	STRING	No	Alternativa a Id: el codigo corto

Ejemplos de código

curl -X POST \
  "/call/url-tools/1.0.0/eliminar" \
  -H "X-Api-Key: YOUR_PREFIX.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"param": "valor"}'

import requests

url = "/call/url-tools/1.0.0/eliminar"
headers = {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
}
payload = {"param": "valor"}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code, response.json())

const response = await fetch("/call/url-tools/1.0.0/eliminar", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"param": "valor"}),
});
const data = await response.json();
console.log(data);

POST /call/url-tools/1.0.0/listar desde $1.00 MXN/petición

Parámetros

Nombre	Ubicación	Tipo	Requerido	Descripción
Tipo	BODY	STRING	No	LINK, QR o TEXT. Vacio = todos
Pagina	BODY	INTEGER	No	Pagina a devolver, base 1. Default 1
PorPagina	BODY	INTEGER	No	Elementos por pagina, de 1 a 200 (se recorta). Default 100

Ejemplos de código

curl -X POST \
  "/call/url-tools/1.0.0/listar" \
  -H "X-Api-Key: YOUR_PREFIX.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"param": "valor"}'

import requests

url = "/call/url-tools/1.0.0/listar"
headers = {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
}
payload = {"param": "valor"}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code, response.json())

const response = await fetch("/call/url-tools/1.0.0/listar", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"param": "valor"}),
});
const data = await response.json();
console.log(data);

POST /call/url-tools/1.0.0/qr desde $1.00 MXN/petición

Parámetros

Nombre	Ubicación	Tipo	Requerido	Descripción
Contenido	BODY	STRING	Sí	Texto o URL que codifica el QR
Color	BODY	STRING	No	Color hexadecimal del modulo, con o sin almohadilla
Descripcion	BODY	STRING	No	Nota interna
MaxUsos	BODY	INTEGER	No	Escaneos maximos. Ausente o 0 = sin limite
Dias	BODY	INTEGER	No	Vigencia en dias (se recorta a 3650)
Expira	BODY	STRING	No	Caducidad exacta ISO-8601. Gana sobre Dias
Permanente	BODY	BOOLEAN	No	true ignora MaxUsos, Dias y Expira

Ejemplos de código

curl -X POST \
  "/call/url-tools/1.0.0/qr" \
  -H "X-Api-Key: YOUR_PREFIX.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"param": "valor"}'

import requests

url = "/call/url-tools/1.0.0/qr"
headers = {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
}
payload = {"param": "valor"}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code, response.json())

const response = await fetch("/call/url-tools/1.0.0/qr", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"param": "valor"}),
});
const data = await response.json();
console.log(data);

POST /call/url-tools/1.0.0/texto/ocultar desde $1.00 MXN/petición

Parámetros

Nombre	Ubicación	Tipo	Requerido	Descripción
Texto	BODY	STRING	Sí	Texto a ocultar. Se guarda cifrado
Password	BODY	STRING	No	Contrasena para abrir el enlace
Descripcion	BODY	STRING	No	Nota interna
MaxUsos	BODY	INTEGER	No	Lecturas maximas. Ausente o 0 = sin limite
Dias	BODY	INTEGER	No	Vigencia en dias (se recorta a 3650)
Expira	BODY	STRING	No	Caducidad exacta ISO-8601. Gana sobre Dias
Permanente	BODY	BOOLEAN	No	true ignora MaxUsos, Dias y Expira

Ejemplos de código

curl -X POST \
  "/call/url-tools/1.0.0/texto/ocultar" \
  -H "X-Api-Key: YOUR_PREFIX.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"param": "valor"}'

import requests

url = "/call/url-tools/1.0.0/texto/ocultar"
headers = {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
}
payload = {"param": "valor"}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code, response.json())

const response = await fetch("/call/url-tools/1.0.0/texto/ocultar", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"param": "valor"}),
});
const data = await response.json();
console.log(data);

POST /call/url-tools/1.0.0/texto/revelar desde $1.00 MXN/petición

Parámetros

Nombre	Ubicación	Tipo	Requerido	Descripción
Codigo	BODY	STRING	Sí	Codigo corto que devolvio /texto/ocultar
Password	BODY	STRING	No	Contrasena, si el texto la lleva

Ejemplos de código

curl -X POST \
  "/call/url-tools/1.0.0/texto/revelar" \
  -H "X-Api-Key: YOUR_PREFIX.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"param": "valor"}'

import requests

url = "/call/url-tools/1.0.0/texto/revelar"
headers = {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
}
payload = {"param": "valor"}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code, response.json())

const response = await fetch("/call/url-tools/1.0.0/texto/revelar", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_PREFIX.YOUR_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"param": "valor"}),
});
const data = await response.json();
console.log(data);

herramientas_url url-tools

Herramientas URL

Parámetros

Ejemplos de código

Parámetros

Ejemplos de código

Parámetros

Ejemplos de código

Parámetros

Ejemplos de código

Parámetros

Ejemplos de código

Parámetros

Ejemplos de código