Compartir a través de

Use la API web de Microsoft Dataverse

  • Artículo

Puede usar la API web o SDK para .NET para trabajar con datos y definiciones de tablas y columnas en Dataverse.

La API web de Dataverse proporciona una experiencia de desarrollo que puede usarse en una gran variedad de lenguajes de programación, plataformas, y dispositivos. La API web implementa OData (Open Data Protocol), versión 4.0, un estándar de OASIS para crear y consumir API RESTful con orígenes de datos enriquecidos. Puede obtener más información sobre este protocolo en https://www.odata.org/. Los detalles sobre esta norma están disponibles en https://www.oasis-open.org/standards#odatav4.0.

Dado que la API web se basa en estándares abiertos, no proporcionamos ensamblados para una experiencia de desarrollador específica. Puede crear solicitudes HTTP para operaciones específicas o usar bibliotecas de terceros para generar clases para cualquier idioma o plataforma que desee. Puede encontrar una lista de bibliotecas compatibles con OData versión 4.0 en https://www.odata.org/libraries/.

API web y el servicio de organización

Es útil reconocer que el servicio de organización es lo que define la plataforma. La API web proporciona una experiencia de programación RESTful, pero en definitiva todas las operaciones de datos pasan por el servicio de organización subyacente. El servicio de organización define las operaciones admitidas como mensajes. Cada mensaje tiene un nombre. Estos nombres están asociados con los eventos que se usan en el marco de trabajo de eventos para evaluar qué extensiones registradas hay que iniciar. Más información: Marco de trabajo de eventos

La API web permite hacer las mismas operaciones que el SDK para .NET, pero las presenta con estilo RESTful. OData v4 permite usar operaciones con nombre mediante funciones o acciones. La mayoría de los mensajes disponibles en el servicio de organización se exponen como una función o acción con nombre correspondiente. Esos mensajes que se corresponden con operaciones CRUD no están disponibles en la API web porque, al ser un servicio, RESTful, tienen implementaciones que usan los métodos HTTP GET, POST, PATCH y DELETE, pero dentro de la plataforma los mensajes recuperar, crear, actualizar y eliminar solo se invocan tal cual cuando se realizan las operaciones correspondientes mediante los ensamblados de .NET Framework.

Introducción

Ahora que ha leído una descripción general de la API web, continúe con el tema Comenzar con la API web de Dataverse para aprender a escribir su primer programa C# en Visual Studio que utiliza la API web.

Si es desarrollador de JavaScript y desea utilizar la API web en aplicaciones basadas en modelos, vaya a JavaScript del lado del cliente utilizando la API web en aplicaciones basadas en modelos.

Trabajar con datos mediante código
OData - lo mejor para REST
OData Versión 4.0 Parte 1: Protocol Plus Errata 02
OData Versión 4.0 Parte 2: URL Conventions Plus Errata 02
OData Versión 4.0 Parte 3: Common Schema Definition Language (CSDL) Plus Errata 02

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).