Acceso a la cuenta y al proyecto
Utilice una cuenta de API habilitada mediante HTTPS desde una dirección IP permitida. El proyecto debe pertenecer a esa cuenta y no debe estar eliminado. Utilice el identificador único del proyecto procedente del flujo de solicitud de portabilidad, no su identificador numérico de la base de datos ni un número de teléfono. Aplique la codificación de URL al identificador del proyecto al crear una solicitud.
Solicitud
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Respuesta
Ejemplo ficticio de respuesta.
{
"status": {
"code": 200,
"msg": "Project Events",
"results": 1
},
"response": [
{
"id": 31,
"subject": "Example project update",
"event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
"type": "comment",
"value": "Example update",
"source": "Example source",
"date_created": "2026-10-23 12:00:00"
}
]
}Un proyecto existente sin eventos devuelve el código 200 de la API, una lista vacía y status.results igual a 0. Los resultados se solicitan en orden descendente de fecha y hora de creación, sin ningún criterio de ordenación adicional para los empates, paginación, cursor ni filtro de fecha.
Lea con atención la carga útil del evento
id es el identificador numérico de la fila del evento, subject es su asunto almacenado y date_created es su valor de fecha y hora almacenado. El punto de acceso conserva sin modificar la cadena event y también intenta decodificar sus propiedades type, value y source. Si la carga útil no es un objeto JSON o falta una propiedad, el campo correspondiente obtenido del análisis es una cadena vacía.
La carga útil no es una enumeración fija ni sigue un esquema de texto sin formato garantizado. No trate el texto de origen como una identidad verificada ni represente el contenido del evento como HTML. Mantenga los eventos sin procesar en flujos de trabajo autorizados del lado del servidor y muestre únicamente el texto adecuado a los usuarios autorizados. Este punto de acceso no dispone de un filtro de visibilidad de eventos diferenciado para el personal y los clientes, ni de ocultación de contenido.
El historial no garantiza la entrega
Se trata del historial almacenado del proyecto, no de un flujo de webhooks, un cursor de sincronización inmutable ni un registro completo de cada cambio en la base de datos. Por ejemplo, añadir números mediante el manejador de adición de números revisado no crea por sí mismo un evento. Además de consultar los eventos, concilie la lista de números y los recuentos por estado.
Errores y límites
Compruebe tanto la respuesta HTTP como status.code/status.msg. Un proyecto inexistente, eliminado o que no pertenezca a la cuenta devuelve el código 404 de la API con un mensaje que indica que no se ha encontrado el proyecto. También se aplican la autenticación y las restricciones de IP de origen. Los ejemplos no realizan ninguna solicitud real y una respuesta satisfactoria no demuestra que un operador haya aceptado o completado una transferencia.
Efectos
El manejador revisado lee los eventos almacenados y no modifica el proyecto, inicia una transferencia ni carga importes en la cuenta. La visibilidad de los componentes que escriben eventos y las pruebas con cuentas autenticadas siguen formando parte de la revisión pendiente del contrato de la API.