API pública v1

Integra verificaciones.

REST, JSON y límites individuales por API key.

v1 estable

Autenticación

Una clave por integración

Envía tu clave en X-Api-Key. Las claves solo se muestran una vez y en la base de datos se conserva únicamente SHA-256.

X-Api-Key: wijo_live_xxxxxxxxxxxxx
Content-Type: application/json

POST/api/v1/number/request

Reserva un número elegible y debita el precio de la aplicación de forma atómica.

curl -X POST https://number.example.com/api/v1/number/request \
  -H "X-Api-Key: $WIJO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app_id": 1}'

{
  "success": true,
  "data": {
    "sesion_id": 1842,
    "numero_telefono": "+19175550142",
    "expira_en": "2026-07-22 18:30:00"
  }
}

GET/api/v1/number/{id}/status

Consulta hasta obtener exitoso, expirado o cancelado.

{
  "success": true,
  "data": {
    "id": 1842,
    "estado": "exitoso",
    "codigo": "482901",
    "texto": "Your verification code is 482901",
    "remitente": "12345"
  }
}

GET/api/v1/balance

{
  "success": true,
  "data": { "saldo_creditos": 24 }
}

Errores y límites

HTTPSignificado
401API key ausente o inválida
402Créditos insuficientes
409Sin inventario elegible
422Payload inválido
429Límite por minuto excedido