Introducción
El API de Liberaciones de doctorSIM permite realizar pedidos de liberaciones, consultar el estado de un pedido en particular, consultar la disponibilidad de liberación via IMEI para más de 1,300 dispositivos y 350 operadoras de diversos países.
Date de alta como distribuidor y empieza a utilizarlo.
Referencia del API
URL del API
$ curl https://api.doctorsim.com
La librería de Php para el API de doctorSIM está en desarrollo.
El API de Liberaciones de doctorSIM, está basado en la semántica REST
Las solicitudes se deben conformar via HTTPS con acceso via GET, POST y DELETE según el método. Las respuestas se entregan en formato JSON.
Cada usuario tiene un modo SandBox para testar en cualquier momento cualquiera de las funcionalidades servidas por el API de Liberaciones de doctorSIM.
Las llamadas al API tienen una limitación de 500 llamadas cada minuto. Superadas, la respuesta del servidor será un error 409.
Autenticación
No olvides reemplazar httpdsimkey y httpdsimsecret por tus datos de acceso.
$ curl https://api.doctorsim.com \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
La librería de Php para el API de doctorSIM está en desarrollo.
La autenticación se lleva a cabo en cada llamada al API, incluyendo el DSIM_KEY y el DSIM_SECRET como cabeceras de la llamada.
Estos parámetros los encontrarás en tu Panel de Liberaciones.
Todas las peticiones deben ser realizadas con HTTPS. Las llamadas realizadas a través de HTTP devolverán fallos de conexión.
Errores
doctorSIM utiliza códigos de estado HTTP como respuesta a las llamadas realizadas al API de Liberaciones. En general, los códigos del tipo 2xx indican estado de éxito, los códigos 4xx indican algún error en la llamada (ej: parámetros olvidados, fallo en la llamada, ...) y los códigos del tipo 5xx indican errores del servidor de doctorSIM (estos son poco comunes).
No todos los códigos de error tienen exactamente el mismo significado que los mensajes de error asociados a los códigos de estado HTTP.
Puedes consultar el significado de los códigos de error en Errores.
Métodos
$ curl https://api.doctorsim.com/{accion}/{parametro} \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
{
"code":"200",
"status":"OK",
"info":"",
"res":{ ... }
}
La librería de Php para el API de doctorSIM está en desarrollo.
Todas las peticiones deben ser realizadas con HTTPS. Las llamadas realizadas a través de HTTP devolverán fallos de conexión.
Algunos métodos requieren de parámetros adicionales en la llamada para modificar la forma en la que obtendremos los datos.
Ejemplo de formato de una petición:
https://api.doctorsim.com/{acción o tipo de consulta}/{parámetro adicional}/{parámetro adicional}/...
Respuesta:
La respuesta será entregada en formato JSON con la siguiente estructura:
| Parámetro | Descripción |
|---|---|
| code integer | Código de estado HTTP |
| status string | OK o WRONG_ACCESS o TOO_MANY_REQUESTS o API_ERROR |
| info string | En caso de error, informa de la causa. Sino, se queda vacío. |
| res object | Contiene el resultado de la solicitud realizada. |
Puedes consultar el significado de los códigos de error en Errores.
Países (GET)
$ curl https://api.doctorsim.com/countries \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"id":"country"
}
}
Ejemplo de respuesta:
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"1146":"Argentina",
"1932":"Canada",
"1937":"China"
}
}
La librería de Php para el API de doctorSIM está en desarrollo.
Solicitar listado de paises disponibles.
https://api.doctorsim.com/countries
Respuesta:
| Parámetro | Descripción |
|---|---|
| id integer | El identificador del país. |
| country string | El nombre del país. |
Operadores (GET)
$ curl https://api.doctorsim.com/networks \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
$ curl https://api.doctorsim.com/networks/{id_pais} \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"country":{
"id":"network"
}
}
}
Ejemplo de respuesta:
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"34":{
"1":"Movistar",
"2":"Vodafone",
"3":"Orange",
"4":"Yoigo"
}
}
}
La librería de Php para el API de doctorSIM está en desarrollo.
Solicitar listado de operadoras disponibles.
- Todos los operadores:
https://api.doctorsim.com/networks
- Los operadores del pais indicado:
https://api.doctorsim.com/networks/{id_pais}
Respuesta:
| Parámetro | Descripción |
|---|---|
| id integer | El identificador del operador. |
| network string | El nombre del operador. |
Marcas (GET)
$ curl https://api.doctorsim.com/brands \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"id":{
"brand":"nombre marca",
"desc":"descripción de la marca"
}
}
}
Ejemplo de respuesta:
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"1":{
"brand":"Alcatel"
"desc":""
},
"6":{
"brand":"LG",
"desc":""
},
"15":{
"brand":"Samsung",
"desc":""
},
"29":{
"brand":"iPhone",
"desc":""
}
}
}
La librería de Php para el API de doctorSIM está en desarrollo.
Solicitar listado de marcas disponibles.
https://api.doctorsim.com/brands
Respuesta:
| Parámetro | Descripción |
|---|---|
| id integer | El identificador de la marca. |
| brand string | El nombre de la marca. |
| desc string | Datos adicionales asociados a la marca. |
Terminales (GET)
$ curl https://api.doctorsim.com/devices/{id_marca} \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
$ curl https://api.doctorsim.com/devices/{id_marca}/{id_terminal} \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"brand_id":{
"id":{
"name":"nombre terminal",
"img":"url imagen",
"desc":"descripción del terminal"
}
}
}
}
Ejemplo de respuesta:
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"29":{
"15910":{
"name":"iPhone 6",
"img":"https://img1.doctorsim.com/img/term/iphone_6.png",
"desc":"Ultrafino y potente, el <B>iPhone 6 de Apple</B> reúne todas las características para que el amor llegue a la tecnología para quedarse. Sus 4,7 pulgadas y sus revolucionarios componentes hacen del <B>iPhone 6</B> el smartphone perfecto para poder conjugar calidad, belleza y prestaciones. La mejor versión de Apple para el modelo más fino y ligero de los iPhone.
Lánzate a <B>liberar tu iPhone 6</B> y podrás utilizar este maravilloso móvil con cualquier compañía del mercado estés donde estés. Revisa los colores de su pantalla retina de lata definición HD y pon en práctica todo el potencial de su chip A8 para que su software se adapte a tí como un guante.<p>
<p>Dispara su cámara fotográfica de última generación y pon en práctica la seguridad del sensor de huellas dactilares para que nadie toque tu iPhone 6.<p>
<p>Lo mejor de todo es que la liberación del iPhone 6 es rápida y segura, con la calidad que un teléfono de sus características requiere. Recibirás una asesoría perfecta para tus consultas, el precio será inigualable y la velocidad del desbloqueo será tan rápida como su procesador.<p>
<p>La garantía de fábrica del iphone 6 se mantiene intacta y no tienes que enviarlo por correo. La <B>liberación del iPhone 6</B> se hace por correo electrónico y con iTunes.<p>
<p>Ya sabes lo que puedes hacer para tener tu iPhone 6 a pleno rendimiento y dando uso a su máxima potencia: <B>Libera tu iPhone 6 con doctorSIM</B> sin perder la garantía a través del método IMEI.<p>"
}
}
}
}
La librería de Php para el API de doctorSIM está en desarrollo.
Solicitar listado de todos los terminales disponibles.
- Los terminales de la marca indicada:
https://api.doctorsim.com/devices/{id_marca}
- Un terminal en concreto:
https://api.doctorsim.com/devices/{id_marca}/{id_terminal}
Respuesta:
| Parámetro | Descripción |
|---|---|
| id integer | El identificador del terminal. |
| name string | El nombre del terminal. |
| img string | La URL de la imagen correspondiente al terminal. |
| desc string | La descripción del terminal. |
Herramientas (GET)
$ curl https://api.doctorsim.com/tools/{id_terminal}/{id_operador} \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"tools":[
{
"name":"nombre de la herramienta",
"desc":"descripción de la herramienta",
"service_name":"nombre del servicio",
"service_desc":"descripción del servicio",
"guaranteed_time":{
"min":"tiempo mínimo",
"max":"tiempo máximo",
"type":"medida temporal"
},
"average_time":"tiempo medio",
"sn":"sn",
"prd":"prd",
"pin":"pin",
"mep":"mep",
"sro":"sro",
"id_tool":"identificador de la herramienta asociada",
"success_ratio":"porcentaje de éxito",
"tool_type":"tipo de tool",
"custom":"custom",
"price":"precio servicio"
},
{ ... }
]
}
}
Ejemplo de respuesta:
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"tools":[
{
"name":"Samsung - EE.UU. Servicio Básico",
"desc":"El Servicio Básico consulta una base de datos LOCAL. Es la solución más económica y tiene una tasa éxito muy elevada. Si tu código no está disponible en la base de datos local, te devolveremos el total de tu pago automáticamente para que puedas solicitar el Servicio Premium que consulta una base de datos MUNDIAL y garantiza así la disponibilidad de tu código. ¡IMPORTANTE! Si tu Samsung ha pasado por el servicio técnico o lo has intentado liberar antes por código sin éxito, haz el pedido directamente por el Servicio Premium. Válido para cualquier modelo Samsung.",
"service_name":"Servicio Básico",
"service_desc":"La opción más económica. Tasa de éxito: 41%. Devolución garantizada si no hay código con este servicio.",
"guaranteed_time":{
"min":"1",
"max":"6",
"type":"days"
},
"average_time":"2 days, 8 hours",
"sn":"false",
"prd":"false",
"pin":"false",
"mep":"false",
"sro":"false",
"id_tool":"452787",
"success_ratio":"0.72",
"tool_type":"imei",
"custom":"",
"price":24.95
}
]
}
}
La librería de Php para el API de doctorSIM está en desarrollo.
Solicitar listado de las herramientas (servicios de liberaciones) disponibles para un terminal y operador dados.
https://api.doctorsim.com/tools/{id_terminal}/{id_operador}
Respuesta:
| Parámetro | Descripción |
|---|---|
| tools array | Los diferentes servicios que se pueden usar para realizar la liberación. |
| name string | El nombre de la herramienta de liberación. |
| desc string | La descripcion de la herramienta de liberación. |
| service_name string | El nombre del servicio. |
| service_desc string | La descripcion del servicio. |
| guaranteed_time object | Objeto que representa el tiempo asegurado de entrega. |
| min integer | Valor minimo del tiempo de entrega. |
| max integer | Valor máximo del tiempo de entrega. |
| type string | El valor de la medida temporal del tiempo de entrega. |
| average_time string | El tiempo medio de entrega del servicio. | sn string | Flag que indica si el pedido requiere Serial Number (también conocido como KBH, referencia o Provider ID). Valores posibles true o false. |
| prd string | Flag que indica si el pedido requiere PRD (id de un terminal Blackberry). Valores posibles true o false. |
| pin string | Flag que indica si el pedido requiere el PIN del teléfono (número de indentificación personal del terminal). Valores posibles true o false. |
| mep string | Flag que indica si el pedido requiere MEP (números de identificación de una Blackberry). Valores posibles true o false. |
| sro string | Flag que indica si el pedido requiere SRO (número de serie de un Alcatel). Valores posibles true o false. |
| id_tool integer | El identificador del servicio. |
| success_ratio decimal | Porcentaje de éxito de entrega del servicio. * |
| tool_type string | El tipo de servicio. Normalmente: imei, fichero, usb, … (Las especificaciones de cada uno pueden venir en el campo desc o en el campo custom). |
| custom object | Campo adicional para parámetros especiales. Es un objeto que puede tener uno o mas registros de la forma clave: valor. |
| price number (float, decimal, ...) | El coste en créditos por uso del servicio. |
Crear Solicitud (POST)
$ curl https://api.doctorsim.com/create_order/{id_terminal}/{id_operador}/{imei}/{id_servicio} \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"id_ticket":"identificador del pedido"
}
}
Ejemplo de respuesta:
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"id_ticket":"1509403"
}
}
La librería de Php para el API de doctorSIM está en desarrollo.
Solicitar la liberación por imei de un dispositivo.
https://api.doctorsim.com/create_order/{id_terminal}/{id_operador}/{imei}/{id_servicio}
- Caso de Serial Number (SN, KBH, referencia o Provider ID) solicitado:
imei: 011950004980028SN5678G-33574
(SN seguido de cadena de tamaño 4 o 5, seguido de guión, seguido de cadena de tamaño de 5 a 7. Todo sin espacios)
- Caso de PRD solicitado:
imei: 011950004980028PRD12345678
(PRD seguido de ocho dígitos sin espacios)
- Caso de PIN solicitado:
imei: 011950004980028PIN21FB6301
(PIN seguido de cadena de ocho caracteres sin espacios)
- Caso de MEP solicitado:
imei: 011950004980028MEP-12345-678
(MEP seguido de un guión, seguido de cinco dígitos, seguido de un guión, seguido de tres dígitos. Todo sin espacios)
- Caso de SRO solicitado:
imei: 011950004980028SROXM66NA40
(SRO seguido de X mayúscula, seguido de cualquier cadena con tamaño entre 7 y 11, sin espacios)
Respuesta:
| Parámetro | Descripción |
|---|---|
| id_ticket integer | El identificador del pedido generado. |
Consultar Solicitud (GET)
$ curl https://api.doctorsim.com/check_order_status/{id_ticket} \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"id_ticket":{
"id_device":"identificador del terminal",
"id_network":"identificador del operador",
"imei":"imei",
"creation_datetime":"fecha de creación",
"status":"status",
"ok_sent":"ok_sent"
}
}
}
Ejemplo de respuesta:
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"1509403":{
"id_device":"1697",
"id_network":"3",
"imei":"011950004980028",
"creation_datetime":"2011-10-04 15:29:18",
"status":"available",
"ok_sent":"true"
}
}
}
La librería de Php para el API de doctorSIM está en desarrollo.
Solicitar informacion de una consulta realizada.
https://api.doctorsim.com/check_order_status/{id_ticket}
Respuesta:
| Parámetro | Descripción |
|---|---|
| id_device integer | El identificador del terminal solicitado. |
| id_network integer | El identificador del operador solicitado. |
| imei string | El IMEI para el que se solicita la liberación. |
| creation_datetime string | La fecha en la que el pedido es recibido. |
| status string | El estado del pedido: consultar en la siguiente tabla. |
| ok_sent string | Flag que indica si las instrucciones están disponibles. Valores posibles true o false. |
Estados de un pedido:
| Parámetro | Descripción |
|---|---|
| open | La solicitud ha sido recibida. |
| pending | Indica que la solicitud se ha procesado y estamos a la espera de una respuesta del servidor de liberaciones. |
| available | Indica que el codigo de liberación está disponible. |
| canceled | Indica que la solicitud ha sido cancelada (y devuelta). |
| notavailable | Indica que el código de liberación no está disponible (y devolución). |
| error | Indica que ha ocurrido algún error durante el proceso de solicitud. |
Actualizar Solicitud (POST)
$ curl https://api.doctorsim.com/update_order/{id_ticket} \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
-d force={value}
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"id_ticket":{
"id_device":"identificador del terminal",
"id_network":"identificador del operador",
"imei":"imei",
"creation_datetime":"fecha de creación",
"status":"status",
"ok_sent":"ok_sent"
}
}
}
Ejemplo de respuesta:
{
"code":"200",
"status":"OK",
"info":"",
"res":{
"1509403":{
"id_device":"1697",
"id_network":"3",
"imei":"011950004980028",
"creation_datetime":"2011-10-04 15:29:18",
"status":"available",
"ok_sent":"1"
}
}
}
La librería de Php para el API de doctorSIM está en desarrollo.
Actualiza un pedido realizado en base a los parámetros pasados.
https://api.doctorsim.com/update_order/{id_ticket}
Argumentos:
| Argumento | Descripción |
|---|---|
| force string | Valores permitidos: - nowait: El uso de este parámetro anula el guaranteed_time del servicio solicitado y fuerza que el servicio esté listo. Podremos consultar las instrucciones u obtener un estado de notavailable sin demora. |
Respuesta:
| Parámetro | Descripción |
|---|---|
| id_device integer | El identificador del terminal solicitado. |
| id_network integer | El identificador del operador solicitado. |
| imei string | El IMEI para el que se solicita la liberación. |
| creation_datetime string | La fecha en la que el pedido es recibido. |
| status string | El estado del pedido. Ver estados disponibles en tabla Estados de un pedido en el método Consultar Solicitud. |
| ok_sent string | Flag que indica si las instrucciones están disponibles. Valores posibles true o false. |
Cancelar (DELETE)
$ curl https://api.doctorsim.com/cancel_order/{id_ticket} \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
{
"status":"OK",
"info":"",
"res":{
"id_ticket":{
"status":"estado de la solicitud"
}
}
}
Ejemplo de respuesta:
{
"status":"OK",
"info":"",
"res":{
"1509403":{
"status":"canceled"
}
}
}
La librería de Php para el API de doctorSIM está en desarrollo.
La cancelación de un pedido está sujeta a que el pedido no haya sido solicitado a nuestros servidores de liberación.
doctorSIM ofrece un período ventana de 10 minutos antes de procesar cualquier pedido, con excepción de algunos servicios como los de Chequeo de Imei.
Una cancelación que no se puede llevar a cabo será indicado con un estado específico que podemos comprobar en API Errors.
https://api.doctorsim.com/cancel_order/{id_ticket}
Respuesta:
| Parámetro | Descripción |
|---|---|
| status string | El estado del ticket. |
Instrucciones (GET)
$ curl https://api.doctorsim.com/retrieve_order_instructions/{id_ticket} \
-H "DSIM_KEY: httpdsimkey" \
-H "DSIM_SECRET: httpdsimsecret"
{
"status":"OK",
"info":"",
"res":{
"id_ticket":{
"howto":"El mensaje indicando cómo proceder a la liberación."
}
}
}
}
Ejemplo de respuesta:
{
"status":"OK",
"info":"",
"res":{
"id_ticket":{
"howto":"Número de IMEI: 123456789876543
Terminal: Nokia 5230
Operadora de Teléfono: Movistar
Pasos para liberar tu teléfono:
1.- Enciende el terminal con cualquier SIM de Movistar
(En los modelos actuales, no es necesario tener SIM insertada)
2.- Si la tarjeta tiene PIN, escribe correctamente el código PIN y pulsa OK
3.- Introduce tu código de liberación: #pw+123456+1#
Para introducir la p debes pulsar 3 veces la tecla * (asterisco).
Para introducir la w debes pulsar 4 veces la tecla * (asterisco).
Para introducir la + debes pulsar 2 veces la tecla * (asterisco).
NOTA: Si tu teléfono tiene teclado QWERTY (completo), no hace falta marcar varias veces * para la p, w y +
Al marcar la última almohadilla (#) el teléfono le responderá automáticamente con el siguiente mensaje:
"Phone restriction off" o "Restricción SIM desactivada" ---> El teléfono ha quedado liberado correctamente y se reiniciará.
"Imposible deshacer restricción SIM" o "No permitido" --> El terminal tiene los intentos de liberación agotados, pero el código que le estás marcando es válido. Para reiniciar el contador y poder liberarlo, puedes seguir el siguiente tutorial: http://bit.ly/Contador_Nokia
** SI MUESTRA OTRO MENSAJE, POR FAVOR, AVÍSANOS **
Recuerda que solo tienes 3 intentos para liberar tu móvil y si el contador está agotado, la única opción es la liberación por cable.
REVISA bien tu código antes de introducirlo para agotar el mínimo número de intentos."
}
}
}
}
La librería de Php para el API de doctorSIM está en desarrollo.
Solicitar las instrucciones de liberación de un pedido.
Las instrucciones varían entre las diferentes marcas e incluso entre terminales y operadores.
https://api.doctorsim.com/retrieve_order_instructions/{id_ticket}
Respuesta:
| Parámetro | Descripción |
|---|---|
| howto string | Las instrucciones de liberación del pedido solicitado. |
Errores
Existen dos tipos de errores que debemos manejar:
- Los errores HTTP:
Estos serán devueltos directamente como respuesta a una llamada que provoque dichos errores.
- Los errores del API:
Estos vendrán indicados en el campo info.
{"status":"API_ERROR","info":"El mensaje de error.","res":{ ... }}
Códigos de error HTTP
| Código de error | Significado |
|---|---|
| 200 | OK: – Everything worked as expected. |
| 400 | Bad Request: – The request was unacceptable, often due to missing a required parameter. |
| 401 | Unauthorized: – No valid API key provided. |
| 404 | Not Found: – The requested resource doesn´t exist. |
| 405 | Method not allowed: – A request method is not supported for the requested resource. |
| 429 | Too Many Requests: – Too many requests hit the API too quickly. |
| 500 | Server Error: – Something went wrong on doctorSIM's end. (These are rare.) |
Errores del API
| Código de error | Significado |
|---|---|
| WRONG_ACCESS | Los datos de acceso son incorrectos. |
| TOO_MANY_REQUESTS | Demasiadas conexiones realizadas. Consulte Referencia del API para conocer la limiración del API. |
| API_ERROR | Indica un error en la operación, tendremos que revisar el campo info para ver de qué error se trata. |
Pruebas
Todos los métodos definidos en la sección Métodos están activos en el modo SandBox.
A continuación se definen una serie de números IMEI con los que forzar los diferentes estados de una solicitud.
| IMEI | Estado Forzado |
|---|---|
| 123456789876543 | La solicitud es available y entrega instrucciones de liberación. |
| 355710060480006 | La solicitud es notavailable y realiza la devolucion del pedido. |
Buenas prácticas del API
Para mejorar el rendimiento y optimizar el uso del API, doctorSIM sugiere hacer uso de las siguientes buenas prácticas.
General
- Realizar todas las pruebas en modo SandBox antes de activar el modo de producción.
- En el modo SandBox, recuerda que puedes Actualizar una Solicitud para obtener de forma inmediata y sin esperas el resultado del pedido de pruebas.
Llamadas al API y cacheo
Durante el desarrollo, recomendamos cachear los resultados de los siguientes métodos y hacer un refresco de los mismos cada X horas, para tener siempre datos actualizados.
Los siguientes métodos pueden ser actualizados una vez al día y cacheados:
Construyendo la Página de Pedidos
Cuando construyas la Página de Pedidos te recomendamos que uses el siguiente flujo para las consultas al API:
- País --> Operador
- Marca --> Terminal
- Con el Identificador del operador y del terminal, se realiza la llamada a Herramientas para mostrar Precio, Tiempos de Entrega, y las diferentes Opciones del Servicio.
Herramientas
La respuesta del método Herramientas puede ofrecer más de una opción para realizar la liberación. Por ejemplo, Movistar (1) and Apple iPhone 5 (15429) https://api.doctorsim.com/tools/15429/1 (POST). Recomendamos mostrar todas las opciones disponibles pero siempre se puede hacer una selección basando la búsqueda en el porcentaje de éxito (valor de 0 a 1)
Algunas herramientas necesitan información adicional como el SN o el Provider Numer (LG, Alcatel, BB, ...). Estas necesidades vienen indicadas en la respuesta de la herramienta.
A la hora de mostrar las opciones de los servicios de liberación al cliente, además del precio, recomendamos mostrar también los siguientes parámetros:
- Nombre del servicio de liberación (name)
- Descripción del servicio (desc)
- Los tiempos de liberación
- Porcentaje de éxito
Los tiempos de entrega se dividen en: Tiempo Medio de entrega y Tiempo Garantizado.
- El tiempo medio se calcula a los últimos 20 pedidos realizados usando el servicio indicado.
- El tiempo garantizado representa el mínimo y máximo rango temporal en el que el proveedor entrega una respuesta a una solicitud.
A la hora de mostrar los tiempos de entrega, el tiempo medio es un valor comercial pero hay que enfatizar que el tiempo garantizado es el verdadero valor de referencia.
Realizando un pedido y Chequeando su estado.
Al realizar un nuevo pedido se devolvera un identificador de pedido usado en los métodos de chequeo del pedido.
Debido a los chequeos internos y comprobaciones, una nueva solicitud puede llegar a tardar hasta 30 segundos.
Una vez que realizamos una nueva solicitud y tenemos el identificador de la nueva orden, recomendamos realizar las consultas de estado en base al tiempo de liberación de la herramienta, en concreto, al parámetro type.
Tiempo Garantizado de Entrega (tools -> time -> type):
- instant: hacer el chequeo tras recibir el identificador del pedido.
- hours: haceer el chequeo cada 15 min.
- days: hacer el chequeo cada hora.
- weeks: hacer el chequeo dos veces al día.
Si Consultar Solicitud nos dice que el pedido está disponible, haremos una llamada adicional a Instrucciones para obtener las instrucciones de liberación.
Cancelar un pedido
Los pedidos pueden ser cancelados durante un período ventana de 10 minutos que empieza inmediatamente después de haber realizado el pedido. Para ello, usaremos el método Cancelar. Después de estos 10 minutos, el pedido no podrá ser cancelado. Póngase en contacto con nosotros si desea eliminar esta espera de 10 minutos para aquellos pedidos considerados instantáneos.

English
Español