Enviar una inscripción en un directorio telefónico

Enviar una inscripción al directorio de un operador

Envíe el nombre y la dirección que se utilizarán para inscribir en un directorio un número de teléfono apto que le pertenezca en MultiTEL. Se trata de una actualización de pago ante el operador, no de una consulta del nombre de quien llama, una entrada en una agenda privada ni una actualización general del campo LIDB del inventario del portal.

Envíe únicamente los datos que el cliente haya autorizado para su inscripción en un directorio. Confirme que el operador admite el número antes de utilizar esta ruta antigua. El controlador revisado no comprueba la elegibilidad del proveedor ni el formato internacional del número; su solicitud al operador presupone un número norteamericano y elimina el primer dígito almacenado.

Requisitos de la cuenta y del número

Utilice una cuenta de API habilitada a través de HTTPS desde una dirección IP de origen permitida. El número exacto debe figurar en un registro no anulado de números comprados perteneciente a esa cuenta. Utilice todos los dígitos internacionales del número tal como aparece en su inventario, por ejemplo, el formato con código de país 1 para un número norteamericano admitido. No utilice un identificador de plan de precios, un UUID de número ni un número perteneciente a otra cuenta.

Solicitud POST con formulario

Establezca NUMBER con el número que le pertenece. Sustituya el ejemplo ficticio por los datos autorizados para la inscripción. Esta ruta lee los campos del formulario de POST; no procesa un cuerpo application/json.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "lastname=EXAMPLE" \
  --data-urlencode "firstname=EXAMPLE" \
  --data-urlencode "streetnum=1" \
  --data-urlencode "streetname=Example" \
  --data-urlencode "streetpredir=N" \
  --data-urlencode "streetpostdir=W" \
  --data-urlencode "city=Example City" \
  --data-urlencode "state=NY" \
  --data-urlencode "postalcode=10001" \
  "https://api.multitel.net/v3/directory/$NUMBER"

Las orientaciones y la dirección del ejemplo son datos de muestra, no una dirección postal recomendada. No añada una orientación ficticia a los datos reales de un cliente. Las comprobaciones de campos obligatorios de la API son superficiales: no establecen que una dirección sea válida ni que el operador la acepte, y el sitio web antiguo aplicaba requisitos de formulario diferentes.

La implementación puede emitir una advertencia de clave de matriz inexistente cuando falta un componente de orientación opcional o está vacío. Si la respuesta tiene un formato incorrecto o el operador rechaza la dirección, conserve la referencia de la solicitud y pida al equipo de soporte que confirme la inscripción en lugar de enviar repetidamente direcciones modificadas por conjetura.

Funcionamiento de los cargos y los reintentos

El controlador revisado comprueba que haya al menos 10.00 unidades de saldo antes de contactar con el operador. Después de que tanto el operador como la actualización local del número indiquen que la operación se ha realizado correctamente, descuenta 10.00 del saldo de la cuenta y registra una transacción de alta en el directorio. Estos son los importes implementados actualmente, no una nueva propuesta de precios; antes de enviar la solicitud, confirme la moneda de facturación aplicable y el servicio admitido según las condiciones de su cuenta.

La operación no dispone de clave de idempotencia, protección contra pedidos duplicados ni una transacción que abarque el envío al operador, la actualización local y la facturación. Repetir una solicitud con éxito puede provocar otro envío al operador y otro cargo. Un tiempo de espera agotado o un error de la API no demuestra que el operador haya rechazado la solicitud anterior: el proveedor puede haberla aceptado antes de que fallara una actualización local.

Respuesta

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": ""
}

La respuesta normal de éxito contiene una cadena vacía en response y no devuelve un identificador de inscripción ni detalles de finalización. Significa que los flujos del operador y de la actualización local indicaron que la operación se realizó correctamente; no demuestra la publicación en todos los directorios externos, la propagación inmediata ni la futura visualización de la identificación de llamada.

Errores del sistema antiguo

Lea tanto el estado HTTP como los campos del JSON status.code/status.msg. La autenticación y las restricciones de IP de origen también pueden impedir que se obtenga una respuesta utilizable. No utilice GET ni parámetros de consulta para solicitar una actualización solo porque el controlador antiguo carezca de una comprobación explícita del método HTTP.

Verifique antes de volver a intentarlo

1. Antes de enviar la solicitud, confirme el número que le pertenece, su elegibilidad ante el operador, los datos autorizados de la inscripción y el cargo.
2. Envíe la solicitud una sola vez y conserve el resultado de la cuenta sin exponer la dirección del cliente en registros públicos ni en sistemas de análisis.
3. Consulte la inscripción guardada y el historial de transacciones mediante el procedimiento admitido de la cuenta o a través del equipo de soporte. Espere el tiempo de procesamiento confirmado por el operador; esta API no establece ningún plazo garantizado de propagación.
4. Cuando el resultado sea incierto, pida al equipo de soporte que concilie el pedido del operador y la facturación local antes de volver a intentarlo. Una solicitud repetida no es una consulta de estado idempotente.