Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A API Web fornece uma interface de serviço Web RESTful que você pode usar para interagir com dados no Microsoft Dataverse usando uma ampla variedade de linguagens de programação e bibliotecas. Use os recursos a seguir para aprender a redigir solicitações, consultar dados, gerenciar linhas de tabela e executar operações em lote, tudo usando métodos HTTP padrão.
Dica
Novo na API Web do Dataverse? Comece examinando os tipos de API Web e as operações para entender os documentos de serviço OData que definem as entidades, as funções e as ações disponíveis para você.
Observação
As informações nesta seção também se aplicam aos usuários do Dynamics 365 Customer Engagement (local).
Nesta seção
| Artigo | Descrição |
|---|---|
| Redigir solicitações HTTP e manipular erros | Saiba como definir os cabeçalhos HTTP apropriados e manipular erros ao interagir com a API Web. |
| Consultar dados | Saiba como redigir consultas usando o OData para recuperar dados de coleções de entidades no Dataverse. |
| Criar uma linha de tabela | Envie uma solicitação POST para criar linhas de tabela, incluindo linhas relacionadas em uma única operação de inserção profunda. |
| Recuperar uma linha de tabela | Use uma solicitação GET para recuperar um registro específico por seu identificador exclusivo, incluindo propriedades específicas e registros relacionados. |
| Atualizar e excluir linhas de tabela | Execute operações de atualização, exclusão e upsert em linhas de tabela, incluindo operações em colunas individuais. |
| Associar e desassociar linhas de tabela | Crie e remova relações entre registros usando as propriedades de navegação definidas nos metadados da tabela. |
| Mesclar linhas de tabela | Combine dois registros duplicados em um usando a ação Merge para contas, contatos, clientes potenciais e incidentes. |
| Usar funções | Use funções reutilizáveis com GET solicitações para recuperar dados ou avaliar valores em consultas sem efeitos colaterais. |
| Usar ações | Use operações reutilizáveis com POST solicitações para executar ações que tenham efeitos colaterais, incluindo ações personalizadas. |
| Executar operações em lote | Agrupe várias operações em uma única solicitação HTTP, opcionalmente em um conjunto de alterações para garantir que elas tenham êxito ou falhem como uma unidade. |
| Representar outro usuário | Execute a lógica de negócios em nome de outro usuário, aplicando a função desse usuário e a segurança baseada em objeto. |
| Executar operações condicionais | Utilize ETags para executar recuperações condicionais, controle de simultaneidade otimista e operações *upsert* limitadas. |
| Detectar dados duplicados | Use o MSCRM.SuppressDuplicateDetection cabeçalho para detectar e impedir a criação de registros duplicados. |
| Solucionar problemas de erros de cliente do Dataverse | Identifique e resolva erros comuns de cliente encontrados ao usar a API Web do Dataverse. |
Próximas Etapas
- Autenticar no Dataverse com a API Web — Configure a autenticação antes de fazer sua primeira solicitação.
- Redigir solicitações HTTP e manipular erros — inicie a criação de solicitações com os cabeçalhos corretos e o tratamento de erros.
- Tipos, funções e ações da API Web – explore os documentos de serviço OData que definem as operações disponíveis.