Explore el catálogo de plantillas
Omita el segmento ISO opcional de la ruta para listar las plantillas que devuelve el servicio. Proporcione un código ISO de país para filtrar la lista. El filtro busca coincidencias con la indicación de país de la plantilla, que puede inferirse de un nombre y puede estar vacía.
Utilice los requisitos para elegir una plantilla
Que una plantilla figure en la lista no significa que sea obligatoria o se acepte para todos los números de ese país. Compruebe que el identificador de la plantilla corresponda a los requisitos de documentación justificativa aplicables. Esta lista no genera, firma, carga ni aprueba un documento cumplimentado.
Si no se devuelve ninguna plantilla
Una lista filtrada vacía puede significar que no se encontró ninguna indicación de país coincidente. Una lista sin filtrar vacía también puede deberse a que los datos del servicio de origen no estén disponibles. No interprete ninguno de estos resultados como prueba de que no se requiere ningún documento justificativo.
Revise la copia descargada antes de utilizarla
Un enlace de descarga del catálogo puede devolver una copia con cambios de formato o de imagen de marca. No dé por hecho que se trata de un acuerdo original sin modificaciones ni que descargarlo cumple un requisito de registro. Revise el contenido antes de cumplimentar o firmar cualquier documento.
Cuando el asistente de documentos del portal ofrezca la preparación de acuerdos, utilice su vista previa y su flujo de envío explícito. Para los demás formularios obligatorios, confirme con MultiTEL cuál es el formulario vigente antes de cumplimentarlo. Una plantilla descargada no es un archivo adjunto firmado, un justificante cargado ni la aprobación de un número.
Solicitud
Utilice las credenciales de su cuenta de API habilitada a través de HTTPS. Se admiten la autenticación Basic y los tokens bearer habilitados de la cuenta de API; se aplican las restricciones de la cuenta.
GET con cualquier parámetro documentado en la ruta de la URL.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_supporting_document_templates/$COUNTRY_ISO"| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
iso | string | No | Filtro opcional por código ISO de país. Omita este segmento completo de la ruta para obtener la lista sin filtrar. La comparación no distingue entre mayúsculas y minúsculas. Los valores desconocidos o sin coincidencias devuelven una lista vacía en lugar de un error explícito de país no válido. |
Respuesta
Compruebe status.code en el cuerpo JSON, además del estado HTTP. response es una matriz de objetos con id, name, permanent, iso y url. permanent es de tipo boolean; iso puede estar vacío y puede haberse inferido del nombre de la plantilla. Considere la información del país como una orientación, no como una decisión sobre el cumplimiento de los requisitos. Un catálogo vacío es una respuesta satisfactoria 200 y también puede producirse cuando la consulta al servicio de origen no devuelve datos. El servicio genera la URL; su nombre de host puede diferir del que figura en el ejemplo ilustrativo.
Estructura ilustrativa de la respuesta; no son datos de la cuenta en tiempo real ni una cotización vigente.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"id": "TEMPLATE_ID_FROM_RESPONSE",
"name": "Example supporting-document template",
"permanent": false,
"iso": "US",
"url": "https://api.multitel.net/v3/supporting_document/TEMPLATE_ID_FROM_RESPONSE"
}
]
}Errores
- Compruebe status.code y status.msg para detectar errores de autenticación o del servicio. Un catálogo vacío devuelto correctamente no constituye la aprobación de un documento ni una exención de registro.
Disponibilidad y efectos secundarios
- Esta consulta del catálogo o de los requisitos no crea una identidad, carga un justificante, registra un número ni realiza un pedido.
- Una respuesta satisfactoria del catálogo no constituye la aprobación de sus documentos ni la confirmación de que se puede activar un número seleccionado.