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 vigente de forma atómica. Los importes van en centavos de USD (199 = $1.99). El precio sube con la demanda: envía max_price para no pagar más de lo previsto; si el precio vigente lo supera, la respuesta es 409 y no se cobra.

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, "max_price": 249}'

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

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": 2301 }
}

Errores y límites

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