Alquiler api Tsorbit clientes

Servicio de consultas para aplicaciones autorizadas. Incluye Daviplata, Dale y llaves Bre-B. Cada petición debe llevar token y dispositivo válidos.

Acceso privado Token y dispositivo obligatorios

Cómo autenticarte

Envía estos datos en el encabezado de cada petición. Si falta alguno, recibirás error 401.

Token de acceso

Authorization: Bearer tu_token_de_acceso

Lo entrega Tsorbit al activar tu cuenta. Trátalo como una clave secreta.

ID del dispositivo

X-Device-Id: tu_id_de_dispositivo

Código único de la app o equipo que hace la consulta. Debe coincidir con el registrado en tu plan.

Formato del cuerpo

Content-Type: application/json

Todas las consultas usan método POST con JSON.

Authorization: Bearer tu_token_de_acceso
X-Device-Id: 00000000-0000-0000-0000-000000000001
Content-Type: application/json

Registro de dispositivos

Al contratar el servicio, Tsorbit asocia uno o más dispositivos a tu token. Solo esos dispositivos pueden consultar. Si cambias de servidor o app, solicita un nuevo ID antes de integrar.

Nombre enmascarado

Algunas respuestas traen el nombre completo y otro campo con el nombre parcialmente oculto. El campo se llama nombreOfuscado. Sirve para mostrar datos al usuario sin revelar todo el titular.

{
  "ok": true,
  "nombre": "NOMBRE EJEMPLO APELLIDO",
  "nombreOfuscado": "NOM*** EJE**** APE*****",
  "cedula": "0000000000",
  "banco": "Banco ejemplo"
}

Consultas disponibles

01 POST /api/v1/daviplata/numero

Número Daviplata

Consulta un celular colombiano de 10 dígitos que empiece en 3. Devuelve el titular Daviplata.

{ "numero": "3000000000" }

02 POST /api/v1/dale/numero

Número Dale

Consulta un celular vía Dale. La respuesta indica si tiene cuenta Dale con el campo tieneDale.

{ "numero": "3000000000" }

03 POST /api/v1/breb/llave

Llave Bre-B

Consulta una llave alias, celular o correo. Devuelve titular, cédula, banco y nombre enmascarado.

{ "llave": "@Prueba" }

Sobre esta página

Aquí solo verás la guía de integración. Las consultas reales se hacen desde tu aplicación con el token y el dispositivo que te entregamos. Los valores mostrados son ejemplos de referencia.