\/CreateCustomer<\/strong><\/td>Crear nueva cuenta<\/td> account, name, money, limitMoney, feeRateGroup, type, lockType<\/td><\/tr> \/ModifyCustomer<\/strong><\/td>Modificar cuenta existente<\/td> account, name, limitMoney, feeRateGroup, lockType, validTime<\/td><\/tr> \/DeleteCustomer<\/strong><\/td>Eliminar cuenta<\/td> account (requerido)<\/td><\/tr> \/GetCustomer<\/strong><\/td>Consultar informaci\u00f3n de cuenta<\/td> accounts[], e164s[], filterAgentAccount<\/td><\/tr> \/GetAllCustomers<\/strong><\/td>Obtener todas las cuentas<\/td> key (entero)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n\ud83d\udcca Gesti\u00f3n de Tel\u00e9fonos (Phones)<\/h3>\n\n\n\n\ud83d\udd17 Endpoint<\/th> \ud83d\udccb Funci\u00f3n<\/th> \ud83d\udcdd Par\u00e1metros Clave<\/th><\/tr><\/thead> \/CreatePhone<\/strong><\/td>Crear tel\u00e9fono\/SIP account<\/td> e164, account, password, displayNumber, callLevel, registerType<\/td><\/tr> \/ModifyPhone<\/strong><\/td>Modificar configuraci\u00f3n de tel\u00e9fono<\/td> e164, password, displayNumber, lockType, callLevel, feerateGroup<\/td><\/tr> \/DeletePhone<\/strong><\/td>Eliminar tel\u00e9fono<\/td> e164 (requerido)<\/td><\/tr> \/GetPhone<\/strong><\/td>Consultar informaci\u00f3n de tel\u00e9fono<\/td> e164s[] o accounts[]<\/td><\/tr> \/GetPhoneOnline<\/strong><\/td>Ver tel\u00e9fonos online<\/td> e164s[] (lista de tel\u00e9fonos)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n\ud83d\udcca Gesti\u00f3n de Gateways (Gateways)<\/h3>\n\n\n\n\ud83d\udd17 Endpoint<\/th> \ud83d\udccb Funci\u00f3n<\/th> \ud83d\udcdd Par\u00e1metros Clave<\/th><\/tr><\/thead> \/CreateGatewayMapping<\/strong><\/td>Crear gateway de mapeo (origination)<\/td> name, password, registerType, remoteIps, capacity, priority<\/td><\/tr> \/CreateGatewayRouting<\/strong><\/td>Crear gateway de enrutamiento (termination)<\/td> name, prefix, registerType, remoteIp, protocol, signalPort<\/td><\/tr> \/GetGatewayMapping<\/strong><\/td>Consultar gateways de mapeo<\/td> names[] (opcional)<\/td><\/tr> \/GetGatewayMappingOnline<\/strong><\/td>Ver gateways online con estad\u00edsticas<\/td> names[], softswitchName<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\nEjemplo de Implementaci\u00f3n: Crear Cuenta (VOS3000 API Integraci\u00f3n)<\/h2>\n\n\n\n El siguiente ejemplo muestra c\u00f3mo crear una nueva cuenta en VOS3000 mediante la API, incluyendo todos los par\u00e1metros principales y la estructura de respuesta esperada.<\/p>\n\n\n\n
\ud83d\udcdd Solicitud JSON para Crear Cuenta<\/h3>\n\n\n\nPOST \/external\/server\/CreateCustomer HTTP\/1.1\nHost: 192.168.1.100:8080\nContent-Type: text\/html; charset=UTF-8\n\n{\n \"account\": \"cliente001\",\n \"name\": \"Cliente Empresarial ABC\",\n \"money\": 100.00,\n \"limitMoney\": 500.00,\n \"feeRateGroup\": \"tarifa_mayorista\",\n \"type\": 0,\n \"lockType\": 0,\n \"agentAccount\": \"\",\n \"phoneBookLimit\": 0,\n \"validTime\": 0,\n \"memo\": \"Cuenta creada v\u00eda API\"\n}\n<\/pre>\n\n\n\n\ud83d\udcdd Respuesta Exitosa<\/h3>\n\n\n\n{\n \"retCode\": 0,\n \"exception\": null\n}\n<\/pre>\n\n\n\n\ud83d\udcdd Respuesta con Error<\/h3>\n\n\n\n{\n \"retCode\": -10007,\n \"exception\": \"Not found, operation failed.\"\n}\n<\/pre>\n\n\n\nTipos de Datos y Validaciones<\/h2>\n\n\n\n La API VOS3000 utiliza tipos de datos espec\u00edficos que deben respetarse para evitar errores de validaci\u00f3n. Conocer estos tipos es esencial para implementaciones correctas.<\/p>\n\n\n\n
\ud83d\udcca Tipos de Datos de la API (VOS3000 API Integraci\u00f3n)<\/h3>\n\n\n\n\ud83d\udccb Tipo<\/th> \ud83d\udccf Descripci\u00f3n<\/th> \ud83d\udcdd Ejemplo<\/th><\/tr><\/thead> String<\/strong><\/td>Cadena de hasta 255 caracteres<\/td> “cliente001”<\/td><\/tr> LongString<\/strong><\/td>Cadena de hasta 65,535 caracteres<\/td> Reglas de marcado extensas<\/td><\/tr> Integer<\/strong><\/td>N\u00famero entero<\/td> 0, 1, 2, 100<\/td><\/tr> Double<\/strong><\/td>N\u00famero decimal<\/td> 100.50, 0.015<\/td><\/tr> Boolean<\/strong><\/td>Valor l\u00f3gico<\/td> true, false<\/td><\/tr> Long<\/strong><\/td>Timestamp Unix en milisegundos<\/td> 1666195200000<\/td><\/tr> String[]<\/strong><\/td>Array de strings<\/td> [“cuenta1”, “cuenta2”]<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\nSeguridad y Mejores Pr\u00e1cticas<\/h2>\n\n\n\n Implementar la API VOS3000 de forma segura es cr\u00edtico para proteger los datos de su operaci\u00f3n y evitar accesos no autorizados que podr\u00edan resultar en fraude o p\u00e9rdida de datos.<\/p>\n\n\n\n
\ud83d\udee1\ufe0f Recomendaciones de Seguridad API (VOS3000 API Integraci\u00f3n)<\/h3>\n\n\n\n\ud83d\udd12 Pr\u00e1ctica<\/th> \ud83d\udccb Implementaci\u00f3n<\/th><\/tr><\/thead> Whitelist de IP<\/strong><\/td>Solo permitir IPs autorizadas en configuraci\u00f3n de acceso<\/td><\/tr> HTTPS obligatorio<\/strong><\/td>Usar HTTPS para encriptaci\u00f3n de datos en tr\u00e1nsito<\/td><\/tr> Autenticaci\u00f3n robusta<\/strong><\/td>Implementar tokens de acceso con expiraci\u00f3n<\/td><\/tr> Rate limiting<\/strong><\/td>Limitar n\u00famero de peticiones por minuto<\/td><\/tr> Logs de acceso<\/strong><\/td>Registrar todas las llamadas API para auditor\u00eda<\/td><\/tr> Validaci\u00f3n de entrada<\/strong><\/td>Validar todos los par\u00e1metros antes de enviar<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\nIntegraci\u00f3n con Sistemas Externos<\/h2>\n\n\n\n La API VOS3000 permite integraci\u00f3n con m\u00faltiples sistemas externos para automatizar flujos de trabajo y sincronizar datos entre plataformas.<\/p>\n\n\n\n
\ud83d\udcca Casos de Uso de Integraci\u00f3n<\/h3>\n\n\n\n\ud83d\udd17 Sistema<\/th> \ud83d\udccb Funcionalidad<\/th> \ud83d\udca1 Beneficio<\/th><\/tr><\/thead> CRM (Salesforce, etc.)<\/strong><\/td>Sincronizar clientes, consultar saldo<\/td> Visi\u00f3n 360\u00b0 del cliente<\/td><\/tr> Pasarela de Pago<\/strong><\/td>Recargas autom\u00e1ticas de saldo<\/td> Autoservicio 24\/7<\/td><\/tr> Portal Web<\/strong><\/td>Autogesti\u00f3n de clientes finales<\/td> Reducci\u00f3n de soporte<\/td><\/tr> Sistema de Facturaci\u00f3n<\/strong><\/td>Exportar CDR para facturaci\u00f3n<\/td> Conciliaci\u00f3n autom\u00e1tica<\/td><\/tr> Monitoreo<\/strong><\/td>Alertas de balance, tr\u00e1fico inusual<\/td> Detecci\u00f3n temprana de problemas<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n