Realización de operaciones mediante la API web

La API web proporciona una interfaz de servicio web RESTful que puede usar para interactuar con los datos de Microsoft Dataverse mediante una amplia variedad de lenguajes de programación y bibliotecas. Use los siguientes recursos para aprender a crear solicitudes, consultar datos, administrar filas de tabla y ejecutar operaciones por lotes, todo ello mediante métodos HTTP estándar.

Sugerencia

¿No está familiarizado con la API web de Dataverse? Empiece por revisar los tipos y las operaciones de api web para comprender los documentos del servicio OData que definen las entidades, las funciones y las acciones disponibles.

Nota:

La información de esta sección también se aplica a los usuarios de Dynamics 365 Customer Engagement (local).

En esta sección

Artículo	Descripción
Redacción de solicitudes HTTP y control de errores	Obtenga información sobre cómo establecer los encabezados HTTP adecuados y controlar los errores al interactuar con la API web.
Consultar datos	Aprenda a crear consultas mediante OData para recuperar datos de colecciones de entidades en Dataverse.
Crear una fila de tabla	Envíe una POST solicitud para crear filas de tabla, incluidas las filas relacionadas en una sola operación de inserción profunda.
Recuperar una fila de tabla	Use una GET solicitud para recuperar un registro específico por su identificador único, incluidas propiedades específicas y registros relacionados.
Actualizar y eliminar filas de tabla	Realice operaciones de actualización, eliminación e "upsert" en filas de tabla, incluidas las operaciones sobre columnas individuales.
Asociar y desasociar filas de tabla	Cree y quite relaciones entre registros mediante las propiedades de navegación definidas en los metadatos de la tabla.
Combinar filas de tabla	Combine dos registros duplicados en uno utilizando la acción Merge para cuentas, contactos, prospectos e incidentes.
Uso de funciones	Use funciones reutilizables con GET solicitudes para recuperar datos o evaluar valores en consultas sin efectos secundarios.
Usar acciones	Use operaciones reutilizables con solicitudes POST para llevar a cabo acciones que produzcan efectos secundarios, incluidas acciones personalizadas.
Ejecución de operaciones por lotes	Agrupe varias operaciones en una única solicitud HTTP, opcionalmente dentro de un "change set" para garantizar que tengan éxito o fallen como una unidad.
Suplantar a otro usuario	Ejecute la lógica de negocios en nombre de otro usuario, aplicando el rol del usuario y la seguridad basada en objetos.
Realización de operaciones condicionales	Utilice ETags para realizar recuperaciones de datos condicionales, control optimista de concurrencia y operaciones limitadas de inserción y actualización.
Detección de datos duplicados	Use el MSCRM.SuppressDuplicateDetection encabezado para detectar y evitar la creación de registros duplicados.
Solucionar problemas de errores de cliente de Dataverse	Identifique y resuelva errores de cliente comunes detectados al usar la API web de Dataverse.

Pasos siguientes

• Autenticación en Dataverse con la API web : configure la autenticación antes de realizar la primera solicitud.
• Redacción de solicitudes HTTP y control de errores : empiece a compilar solicitudes con los encabezados y el control de errores correctos.
• Tipos de API web, funciones y acciones : explore los documentos del servicio OData que definen las operaciones disponibles.

Consulte también

Usar la API web de Dataverse