Información general de API web de portales
La API web de los portales permite crear una experiencia de usuario más rica en páginas de portales de Power Apps. Puede utilizar la API web para realizar las operaciones de crear, leer, actualizar y eliminar en todas las tablas de Microsoft Dataverse de las páginas de sus portales. Por ejemplo, puede crear una nueva cuenta, actualizar un contacto o cambiar los permisos de tabla para un producto utilizando la API web de portales en lugar de la aplicación Portal Management.
Importante
- La versión de su portal debe ser 9.3.3.x o posterior para que esta función funcione.
- La API web de los portales se ha diseñado para crear una experiencia de usuario rica en páginas de portales. No está optimizado para servicios de terceros o integración de aplicaciones.
- Las operaciones de la API web de los portales se limitan a tablas relacionadas con los datos.—por ejemplo, cuentas, contactos o sus tablas personalizadas. Configurar metadatos de la tabla o datos de la tabla de configuración del portal—por ejemplo, configurar tablas de portales como adx_contentsnippet, adx_entityform o adx_entitylist—no es compatible con la API web de portales. Para obtener una lista completa, vaya a tablas de configuración no admitidas, más adelante en este tema.
- La API web de los portales se beneficia del almacenamiento en caché del lado del servidor, por lo que las llamadas posteriores a la API web son más rápidas que las llamadas iniciales. Tenga en cuenta que borrar la memoria caché del lado del servidor del portal provoca una degradación temporal del rendimiento.
- Las operaciones de la API web de los portales requieren una licencia de portales de Power Apps. Por ejemplo, las llamadas a la API web realizadas por usuarios anónimos se cuentan para la capacidad de visualización de páginas. Las llamadas a la API web realizadas por usuarios autenticados (internos o externos) no se cuentan para las visitas a la página, pero requieren las licencias correspondientes. Más información: Preguntas frecuentes sobre las licencias de portales de Power Apps
Operaciones de API web
La API web de portales ofrece un subconjunto de capacidades para operaciones de Dataverse que puede realizar mediante la API de Dataverse. Hemos mantenido el formato de API lo más similar posible para reducir la curva de aprendizaje.
Operaciones de API web disponibles en portales
- Leer registros de una tabla
- Crear un registro en una tabla
- Actualizar y eliminar registros en una tabla
- Asociar y desasociar tablas
Configuración del sitio para la API web
Debe habilitar la configuración del sitio para habilitar la API web de portales para su portal. También puede configurar la API web a nivel de campo que determina los campos de la tabla que se pueden modificar o no con la API web de portales.
| Nombre de configuración del sitio | Descripción |
|---|---|
| Webapi/<table name>/enabled | Habilita o deshabilita la API web para <table name>. Predeterminado: False Valores válidos: True, False |
| Webapi/<table name>/fields | Define la lista de atributos separados por comas que se pueden modificar con la API web. Valores posibles: - Todos los atributos: * - Atributos específicos: attr1,attr2,attr3 Nota: el valor debe ser un asterisco (*_) o una lista de nombres de campo separados por comas. _ Importante: esta es una configuración de sitio obligatoria. Cuando falta esta configuración, verá el error "No hay campos definidos para esta entidad". |
| Webapi/error/innererror | Habilita o deshabilita InnerError. Predeterminado: False Valores válidos: True, False |
Nota
La configuración del sitio debe establecerse en Activo para que los cambios surtan efecto.
Por ejemplo, para exponer la API web para la tabla de casos donde los usuarios autenticados pueden realizar operaciones de creación, actualización y eliminación en esta entidad, la configuración del sitio se muestra en la siguiente tabla.
| Nombre de configuración del sitio | Valor de configuración del sitio |
|---|---|
| Webapi/incident/enabled | true |
| Webapi/incident/fields | attr1,attr2,attr3 |
Seguridad con la API web de los portales
Puede configurar la seguridad basada en registros para registros individuales en portales utilizando permisos de tabla. La API web de los portales accede a los registros de la tabla (entidad) y sigue los permisos de la tabla otorgados a los usuarios a través de los roles web asociados.
Autenticación de solicitudes de API web de portales
No es necesario que incluya un código de autenticación, porque la autenticación y la autorización son administradas por la sesión de la aplicación. Todas las llamadas a la API web deben incluir un token de falsificación de solicitud entre sitios (CSRF).
Reglamento General de Protección de Datos (RGPD)
Todos los encabezados de solicitud tendrán un Id. de contacto para fines de auditoría. Para un usuario anónimo, esto se pasará como null.
Si el registro de auditoría está habilitado, un usuario puede ver todos los eventos de auditoría en el registro de auditoría de Office 365.
Más información:
Habilitar y utilizar registro de actividad
Exportar, configurar y ver registros de auditoría
Tablas de configuración no admitidas
La API web de Portals no se puede utilizar para las siguientes tablas de configuración:
adx_contentaccesslevel
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_entitypermission_webrole
adx_externalidentity
adx_pagealert
adx_pagenotification
adx_pagetag
adx_pagetag_webpage
adx_pagetemplate
adx_portallanguage
adx_publishingstate
adx_publishingstatetransitionrule
adx_publishingstatetransitionrule_webrole
adx_redirect
adx_setting
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_urlhistory
adx_webfile
adx_webfilelog
adx_webform
adx_webformmetadata
adx_webformsession
adx_webformstep
adx_weblink
adx_weblinkset
adx_webnotificationentity
adx_webnotificationurl
adx_webpage
adx_webpage_tag
adx_webpageaccesscontrolrule
adx_webpageaccesscontrolrule_webrole
adx_webpagehistory
adx_webpagelog
adx_webrole_systemuser
adx_website
adx_website_list
adx_website_sponsor
adx_websiteaccess
adx_websiteaccess_webrole
adx_websitebinding
adx_websitelanguage
adx_webtemplate
Siguiente paso
Consultar datos utilizando la API web de portales
Consulte también
Componer solicitudes HTTP y administrar errores Operaciones de escritura, actualización y eliminación de portales con la API web Tutorial: Uso del API web del portal