Introduce el token de la API.
El token está en la VPS: /root/secret.txt.
Uso de la API
Toda petición a datos exige el token en una cabecera. Sin él la respuesta es 401.
X-API-Key: <token>
# o también:
Authorization: Bearer <token>
GET https://vpstools.tech/Vanti/api/vanti?ref=NUMERO&project=EMPRESA
| Parámetro | Qué es | Ejemplo |
|---|---|---|
ref | Referencia / cuenta contrato (mínimo 6 dígitos) | 60694485 |
project | 79 Vanti · 80 Cundiboyacense · 81 Nacer · 82 Oriente · 84 Soluciones | 79 |
forzar | Opcional: true ignora la caché | true |
La llamada es servidor-a-servidor (CORS cerrado: no desde el navegador de otro dominio).
curl
curl -H "X-API-Key: $VANTI_TOKEN" \
"https://vpstools.tech/Vanti/api/vanti?ref=60694485&project=79"
Node.js
const r = await fetch("https://vpstools.tech/Vanti/api/vanti?ref=60694485&project=79", {
headers: { "X-API-Key": process.env.VANTI_TOKEN }
});
const data = await r.json();
console.log(data.valor, data.texto);
PHP
$ctx = stream_context_create(["http" => ["header" =>
"X-API-Key: " . getenv("VANTI_TOKEN") . "\r\n"]]);
$data = json_decode(file_get_contents(
"https://vpstools.tech/Vanti/api/vanti?ref=60694485&project=79", false, $ctx), true);
{
"ok": true,
"referencia": "60694485",
"valor": 6280,
"texto": "$6.280",
"empresa": "Vanti S.A. E.S.P.",
"mensaje": "OK",
"segundos": 5.27,
"cache": false
}
| Campo | Lectura |
|---|---|
ok | true hay deuda; false pagada o sin resultado |
valor | Deuda en pesos (entero). 0 = ya pagada |
texto | Deuda formateada ($6.280) |
cache | true respuesta instantánea del registro; false consulta fresca (~5 s) |
| Ruta | Para qué |
|---|---|
GET /Vanti/api/vanti | Consulta de una referencia |
GET /Vanti/logs.json?limite= | Historial de consultas (hora, estado, origen) |
GET /Vanti/referencias.json | Referencias clasificadas: DEUDORA / PAGADA / VACIA |
POST /Vanti/api/sembrar?desde=&cantidad= | Siembra manual en segundo plano |
GET /Vanti/api/sembrar/estado | Progreso del sembrado manual |
GET /Vanti/api/sembrar/auto | Estado del sembrado automático |
POST /Vanti/api/sembrar/auto?pausar= | Pausar / reanudar el automático |
GET /Vanti/health | Estado del servicio (público) |