API Reference
SionSoft API v1
Referencia completa de todos los endpoints disponibles en esta versión.
Autenticación por Bearer JWT. Todas las peticiones son POST con cuerpo JSON.
Base URL
https://api.sionsoft.net/v1
Versión
1.0.0
Protocolo
HTTPS · HTTP/2
Formato
JSON
Autenticación
Todos los endpoints (excepto /auth) requieren un Bearer JWT en el header Authorization.
Header requerido
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Expiración: Los tokens tienen validez de 24 horas. Una vez expirado deberás llamar nuevamente a
/auth para obtener uno nuevo.
Códigos de respuesta
| cod | HTTP | Significado |
|---|---|---|
000 | 200 | Operación exitosa |
100 | 405 | Método no permitido (se requiere POST) |
200 | 400 | JSON inválido en el body |
401 | 401 | Token ausente, inválido o expirado |
500 | 500 | Error interno del servidor |
503 | 503 | Servicio no disponible temporalmente |
Endpoints
POST
/auth
Obtener token JWT
Estable
Autentica al tenant con su login y API token. Devuelve un JWT válido por 24 horas.
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
login |
string |
requerido | Login del tenant (asignado por SionSoft) |
token |
string |
requerido | API Token generado desde el panel de administración |
Respuesta exitosa — 200 OK
{
"api": "SionSoft API v1",
"version": "1.0.0",
"cod": "000",
"token": "eyJhbGciOiJIUzI1NiJ9.eyJ...",
"expires_in": 86400
}
POST
/countries
Listado de países
Estable
Devuelve los países configurados en el tenant. Requiere Bearer JWT.
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
type |
string |
opcional | registro · remesas · vendors · vacío (todos) |
language |
string |
opcional | es · en · pt. Default: es |
Respuesta exitosa — 200 OK
{
"cod": "000",
"reg": [
{
"id": 241,
"code2": "VE",
"code3": "VEN",
"codePhone": "+58",
"name": "Venezuela",
"status": "Activo"
}
]
}
POST
/customer
Datos del cliente autenticado
Estable
Devuelve el perfil completo del cliente asociado al JWT actual.
POST
/balance
Saldo de billeteras
Estable
Devuelve el saldo de todas las billeteras del cliente.
Endpoints adicionales disponibles en v1
POST /wallets
POST /transactions
POST /send_money
POST /beneficiaries
POST /bank_accounts
POST /fees
POST /quotes
POST /register
POST /states
POST /banks
POST /tickets
POST /translate
Para acceso completo a la documentación contacta a [email protected]