API pública v1
Integra verificaciones.
REST, JSON y límites individuales por API key.
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
| HTTP | Significado |
|---|---|
| 401 | API key ausente o inválida |
| 402 | Créditos insuficientes |
| 409 | Sin inventario elegible |
| 422 | Payload inválido |
| 429 | Límite por minuto excedido |