Skip to main content

Visão geral da API

Não exclua isto; contém estilos aplicados ao artigo.

Importante

Caso não tenha experiência com APIs, visite a página de ajuda Introdução às APIs .

Importante

A partir da versão 2022.1, os pontos de extremidade de API OAuth1 públicos herdados foram removidos porque exigem hash SHA1 não compatível com FIPS. Essa remoção inclui os pontos de extremidade WCF (Windows Communication Framework) herdados, o Swagger para esses pontos de extremidade herdados e o middleware de OAuth1. Para substituir os pontos de extremidade OAuth1, você pode usar as versões OAuth2 das APIs herdadas lançadas na versão 21.4, que são compatíveis com FIPS. As APIs OAuth2 oferecem a mesma experiência de funcionalidade das APIs OAuth1.

Os pontos de extremidade V1 e V2 e de assinatura continuarão sendo compatíveis no OAuth2.

Para saber mais sobre a conversão e seus impactos, acesse a página de ajuda Instruções para conversão de OAuth1 para OAuth2 ou este artigo .

A API do Server é composta por seis APIs:

  • API de assinatura : pontos de extremidade para que os usuários interajam com assinaturas, fluxos de trabalho e agendamentos (trabalhos).

  • API V2 de usuário : pontos de extremidade para que os usuários interajam com credenciais, arquivos de entrada e agendamentos (trabalhos).

  • API V1 de administrador : pontos de extremidade para que os administradores busquem recursos da interface do administrador.

  • API V2 de administrador : versão 2 dos pontos de extremidade para que os administradores busquem recursos da interface do administrador.

  • API V3 de administrador : versão 3 dos pontos de extremidade. Esta versão usa OAuth 2.

  • API V3 de usuário : versão 3 dos pontos de extremidade para usuários. Esta versão usa OAuth 2.

Nota

Além de adicionar novas funcionalidades com pontos de extremidade de API V3 , também disponibilizamos nossos pontos de extremidade V1, de assinatura e pontos de extremidade V2 para uso com OAuth 2. Os mesmos pontos de extremidade que você usou anteriormente agora estão disponíveis para OAuth 2 em um novo endereço base.

O endereço da API Web pode ser configurado apenas para V1, V2 e V3 usando o OAuth 2. Para a documentação da API V1 e V2 usando o OAuth 1, o endereço é http://{ServerHostname}/gallery/api-docs/ .

The Web API address can be set up in System Settings.

Acessar a documentação de referência da API do Server

A documentação de referência completa para todos os pontos de extremidade de API do Server está disponível no Swagger.

Há dois locais na IU do Server onde você pode acessar a documentação de referência da API do Server.

  1. Clique no ícone de ponto de interrogação na barra de ferramentas superior e selecione  Documentação da API .

    Thumbnail
  2. Selecione seu nome de usuário e selecione  Meu perfil  >  Chaves . Você pode encontrar links para a documentação da API ao lado das chaves da API.

Você também pode acessar a documentação de referência da API para a API do Server usando este URL: http(s)://serverhostname.domain/webapi/swagger A parte "serverhostname" é o URL da sua instância do Server.

Autenticação na documentação de referência da API do Server

Os documentos da API do Server são interativos, permitindo que você preencha os parâmetros e veja as respostas. Para usar a interatividade, você precisa fazer a autenticação. Para isso, siga estas etapas:

  1. Na IU do Server, selecione seu nome de usuário e vá para Meu perfil > Chaves . Copie as chaves de API para a API na qual deseja se autenticar e cole-as nos campos API Key  (chave de API) e Shared Secret (segredo compartilhado). As chaves serão salvas e exibidas como Saved .

  2. Selecione a chamada que deseja executar, preencha os parâmetros e clique em Try it out! para testar.

Chaves de API e acesso à API

Os administradores do Server precisam permitir que os usuários acessem a API. Acesse Permitir acesso de usuários à API do Server para obter mais informações. Depois que você tiver concedido aos usuários acesso à API, eles poderão encontrar suas chaves de API na guia Chaves da página Meu perfil . Para acessar suas chaves de API, selecione seu nome de usuário e vá para Meu perfil > Chaves .

API keys are located under My Profile Keys.

Os usuários com a função de administrador podem usar as chaves de Acesso à API para acessar todas as APIs, incluindo a API de assinatura, a API V2 de usuário, a API V1 de administrador, a API V2 de administrador e a API V3.

Todos os usuários que não sejam administradores podem usar as chaves de Acesso à API para acessar a API de assinatura e a API V2 de usuário.

Autenticação

Consulte o artigo Configuração e autorização da API do Server para obter mais informações.

Criar pontos de extremidade de API

Para construir um ponto de extremidade de API, use este esquema: <hostname>/webapi/ .

Pontos de extremidade de API e parâmetros

Nesta seção, você encontrará mais informações sobre os seguintes pontos de extremidade:

O Server monitora as alterações feitas nas seguintes entidades do sistema:

  • AppInfo (fluxo de trabalho)

  • Coleção

  • Credencial

  • Assinatura

  • Usuário

  • Grupo de usuário

Obter eventos registrados pela API do Server

Qualquer atualização feita nessas entidades aciona a criação de um registro AuditEvent (evento de auditoria). Você pode fazer o retorno desses registros por meio de um ponto de extremidade público de API de administrador.

Ponto de extremidade

O ponto de extremidade para AuditEvents é GET /admin/v1/auditlog/

Parâmetros de consulta obrigatórios

  • entity : (string) a entidade do log de auditoria a ser consultada.

  • page : (int) a página a ser retornada.

  • pageSize : (int) o número de registros a serem retornados em cada página.

A resposta será uma série de registros de evento de auditoria:

[
  {
    "id": "",
    "entity": "",
    "entityId": "",
    "userId": "",
    "timestamp": "Date",
    "event": "",
    "oldValues": "",
    "newValues": ""
  }
]

As propriedades retornadas estão definidas abaixo:

  • id : o ID do evento de auditoria.

  • entity : o nome da entidade.

  • entityId : o ID da entidade.

  • userId : o ID do usuário que modificou a entidade.

  • timestamp : a data/hora de criação do registro do evento de auditoria.

  • event : o evento que ocorreu (inserção, atualização, exclusão).

  • oldValues : os valores das propriedades antes da atualização.

  • newValues : os valores das propriedades depois da atualização.

Para executar fluxos de trabalho que usam a ferramenta Explorador de Arquivos por meio da API, use o ponto de extremidade /user/v2/inputfiles para fazer upload do arquivo.File Browse Tool Icon Ferramenta Explorador de Arquivos

  1. Comece fazendo uma solicitação POST multipart/form-data para o ponto de extremidade /user/v2/inputfiles para publicar um arquivo temporário. O nome da seção form-data obrigatória é InputFile .

    curl --location --request POST 'http:{yourhostname}/api/user/v2/inputfiles/' \
    --form 'inputFile=@/file/path/filename.csv' 
  2. Em seguida, faça um POST para o ponto de extremidade /user/v2/workflows/{appId}/jobs/ .

    1. Em seguida, inclua o nome ( name ) da ferramenta Explorador de Arquivos no objeto de pergunta. Se você não tiver certeza do nome da ferramenta Explorador de Arquivos, use o ponto de extremidade /v1/workflows/{appId}/questions para obtê-lo.

    2. O value é o ID de referência que a chamada do arquivo de entrada retornou na resposta.

    curl --location --request POST 'http:{yourhostname}/api/user/v2/workflows/{appId}/jobs' \
    --header 'Content-Type: text/plain' \
    --header 'Authorization: OAuth oauth_consumer_key="{consumer key}",
                             oauth_signature_method="HMAC-SHA1",
                             oauth_timestamp="{timestamp}",
                             oauth_nonce="{nonce}",
                             oauth_signature="{signature}"' \
    --data-raw '{
        "questions": [
            {
                "name": "File Browse",
                "value": "{reference ID}"
            }
        ]
        "priority": "Low"
    }'
    

Use o ponto de extremidade migratable para migrar fluxos de trabalho entre ambientes do Server. Você pode usar isso para gerenciar implantações de fluxo de trabalho durante as fases de desenvolvimento e teste.

Para começar, você precisa habilitar fluxos de trabalho para migração . Depois de marcar fluxos de trabalho para migração, siga estas etapas para publicá-los do ambiente de origem na assinatura apropriada (estúdio) de um ambiente de destino.

Etapa 1. Obter uma lista de fluxos de trabalho prontos para migração

Em seguida, obtenha uma lista de fluxos de trabalho prontos para migrar usando o seguinte ponto de extremidade:

  • Ambiente: origem

  • Método: GET

  • Ponto de extremidade: api/admin/v1/workflows/migratable/?subscriptionIds={subscriptionIds}/

Inclua uma lista separada por vírgulas de subscriptionIds  (IDs de assinatura) como um parâmetro de consulta. Os IDs de assinatura identificam um estúdio específico.

O retorno é uma variedade de fluxos de trabalho marcados como prontos para a migração dentro da assinatura especificada (estúdio). Se você não fornecer subscriptionsIds , o retorno incluirá todos os fluxos de trabalho marcados como prontos para migração. O retorno inclui três propriedades: appId  (o ID do aplicativo),  revisionId  (a revisão atualmente publicada) e subscriptionID  (o ID da assinatura à qual o fluxo de trabalho pertence).

Etapa 2. Fazer download dos fluxos de trabalho do ambiente de origem

O ponto de extremidade a seguir baixa o fluxo de trabalho como um arquivo YXZP.

  • Ambiente: origem

  • Método: GET

  • Ponto de extremidade: api/admin/v1/{appID}/package/

Inclua um appID como um parâmetro de caminho. O retorno será um download de todo o fluxo de trabalho como um pacote.

Etapa 3. Publicar fluxos de trabalho no ambiente de destino

O ponto de extremidade a seguir publica o fluxo de trabalho baixado no ambiente de destino.

  • Ambiente: destino

  • Método: POST

  • Ponto de extremidade: api/admin/v1/workflows/

Parâmetros

Parâmetro

Descrição

Tipo

Obrigatório

file

O nome do arquivo do novo fluxo de trabalho.

Cadeia de caracteres

Verdadeiro

name

O novo nome do fluxo de trabalho.

Cadeia de caracteres

Verdadeiro

owner

O proprietário do fluxo de trabalho migrado. O endereço de e-mail deve existir no ambiente de destino.

Cadeia de caracteres

Verdadeiro

validate

Sinalizador para validar o fluxo de trabalho ao migrar para o ambiente de destino.

Booleano

Verdadeiro

isPublic

Sinalizador para definir o fluxo de trabalho como público para ser exibido no "Server da minha empresa" no ambiente de destino.

Booleano

Verdadeiro

sourceId

Este é o appId do ambiente de origem do fluxo de trabalho a ser migrado. Se existir um fluxo de trabalho com o mesmo sourceId, ele será substituído no ambiente de destino. Caso contrário, um novo fluxo de trabalho será gerado.

(Envie uma string vazia se não desejar especificar um appID.)

Cadeia de caracteres

Verdadeiro

workerTag

Adicione ao fluxo de trabalho uma tag de trabalhador para que um trabalhador específico execute o fluxo.

(Envie uma string vazia se não quiser especificar o trabalhador.)

Cadeia de caracteres

Verdadeiro

canDownload

Sinalizador para definir o fluxo de trabalho como disponível para download por outros usuários no ambiente de destino.

Booleano

Verdadeiro

(Opcional) Etapa 4. Redefinir configuração de migração de fluxos de trabalho no ambiente de origem

Se desejar, você pode usar o ponto de extremidade migratable para alternar a configuração Este fluxo de trabalho está pronto para ser migrado em um fluxo de trabalho de volta para Não no ambiente de origem após a migração do fluxo de trabalho no ambiente de destino.

  • Ambiente: origem

  • Método: PUT

  • Ponto de extremidade: api/admin/v1/workflows/migratable/{appID}/

Para obter mais informações sobre todos os pontos de extremidade de API do Server, consulte APIs do Server .

Para obter mais informações sobre os pontos de extremidade de API V3 do Server e seus parâmetros, acesse a página de ajuda API V3 do Alteryx Server .

APIs do Server

Encontre a lista de todas as APIs do Server na tabela abaixo. Se uma API estiver disponível para os usuários, ela estará disponível para os administradores.

Seção

Ponto de extremidade de API

Versão

Build da versão de administrador

Build da versão de usuário

Descrição

1

Logs de auditoria

GET /admin/v1/auditlog

v1

9.1

Recuperar entradas de log de auditoria para um determinado tipo de entidade

2

Coleções

GET /v3/collections

v3

2021.4

Recuperar todos os registros de coleção acessíveis

3

Coleções

POST /v3/collections

v3

2021.4

Crie uma nova coleção.

4

Coleções

DELETE /v3/collections/{collectionId}

v3

2021.4

Excluir uma coleção

5

Coleções

GET /v3/collections/{collectionId}

v3

2021.4

Recuperar um registro de coleção

6

Coleções

PUT /v3/collections/{collectionId}

v3

2021.4

Atualizar uma coleção existente para alterar o nome ou o proprietário

7

Coleções

PUT /v3/collections/{collectionId}/users//permissions

Permissões

v3

2021.4

Atualizar permissões de usuários de uma coleção.

8

Coleções

PUT /v3/collections/{collectionId}/userGroups//permissions

Permissões

v3

2021.4

Atualizar permissões de grupos de usuários de uma coleção

9

Coleções

POST /v3/collections/{collectionId}/users

v3

2021.4

Adicionar um usuário a uma coleção

10

Coleções

POST /v3/collections/{collectionId}/insights

v3

2021.4

Adicionar um insight a uma coleção

11

Coleções

POST /v3/collections/{collectionId}/schedules

v3

2021.4

Adicionar um agendamento a uma coleção

12

Coleções

POST /v3/collections/{collectionId}/workflows

v3

2021.4

Adicionar um fluxo de trabalho a uma coleção

13

Coleções

POST /v3/collections/{collectionId}/userGroups

v3

2021.4

Adicionar um grupo de usuários a uma coleção

14

Coleções

DELETE /v3/collections/{collectionId}/users/{userId}

v3

2021.4

Remover um usuário de uma coleção

15

Coleções

DELETE /v3/collections/{collectionId}/workflows/{appId}

v3

2021.4

Remover um fluxo de trabalho de uma coleção

16

Coleções

DELETE /v3/collections/{collectionId}/insights/{insightId}

v3

2021.4

Remover um insight de uma coleção

17

Coleções

DELETE /v3/collections/{collectionId}

agendamentos

v3

2021.4

Remover um agendamento de uma coleção

18

Coleções

DELETE /v3/collections/{collectionId}

userGroups

v3

2021.4

Remover um grupo de usuários de uma coleção

19

Coleções

GET /admin/v1/collections

v1

9.1

Encontrar coleções em um Server

20

Credenciais

GET /v3/credentials/{credentialId}

v3

2021.4

2022.3

Recuperar um registro de credencial

21

Credenciais

GET /v3/credentials

v3

2021.4

2022.3

Recuperar registros de credencial.

22

Credenciais

DELETE /v3/credentials/{credentialId}

v3

2021.4

Excluir uma credencial

23

Credenciais

POST /v3/credentials/{credentialId}/users

v3

2021.4

Compartilhar uma credencial com um usuário

24

Credenciais

POST /v3/credentials/{credentialId}/userGroups

v3

2021.4

Compartilhar uma credencial com um grupo de usuários

25

Credenciais

DELETE /v3/credentials/{credentialId}/users/{userId}

v3

2021.4

Remove um usuário de uma credencial

26

Credenciais

DELETE /v3/credentials/{credentialId}

userGroups

v3

2021.4

Remove um grupo de usuários de uma credencial

27

Credenciais

GET /user/v2/credentials

v2

11.3

Encontrar credenciais compartilhadas com usuários diretamente ou por meio de uma assinatura

28

DCMEConnections

GET /v3/DCMEConnections/{connectionId}

v3

2022.1

Recuperar uma conexão do DCM.E

29

Insights

GET /admin/v2/insights

v2

11.3

Encontrar insights em um Server

30

Insights

GET /admin/v1/insights

v1

9.1

Encontrar insights em um Server

31

Trabalhos

GET /v3/jobs/

v3

2022.3

2022.3

Recuperar o trabalho e seu estado atual

32

Trabalhos

POST /user/v2/workflows/{appId}/jobs

Nota

Se o fluxo de trabalho foi publicado com uma credencial, uma credencial compartilhada deve ser explicitamente aplicada na chamada da API.

v2

11.3

11.3

Criar um novo trabalho e adicioná-lo à fila de execução de trabalhos

33

Trabalhos

GET /v1/jobs/{id}/output/{outputId}

v1

9.1

9.1

Obter a saída para um determinado trabalho

34

Trabalhos

GET /v1/jobs/{id}

v1

9.1

9.1

Recuperar o trabalho e seu estado atual

35

Trabalhos

GET /v1/workflows/{appId}/jobs

v1

9.1

9.1

Retornar os trabalhos para o aplicativo analítico Alteryx fornecido

36

Trabalhos

POST /v1/workflows/{appId}/jobs

Nota

Use POST /user/v2/workflows/{appId}/jobs se o fluxo de trabalho precisar de uma credencial para ser executado.

v1

9.1

9.1

Colocar na fila uma execução para o fluxo de trabalho especificado com as respostas fornecidas

37

Trabalhos

GET /admin/v1/workflows/jobs

v1

9.1

Retornar o último trabalho executado e seu estado atual para fluxos de trabalho

38

Agendamentos

DELETE /v3/schedules/{id}

v3

2021.4

Excluir um agendamento

39

Agendamentos

GET /v3/schedules/{id}

v3

2021.4

Obter informações para um agendamento específico

40

Agendamentos

PUT /v3/schedules/{id}

v3

2021.4

Atualizar um agendamento existente

41

Agendamentos

GET /v3/schedules

v3

2021.4

Obter todos os agendamentos

42

Agendamentos

POST /v3/schedules

v3

2021.4

Criar um novo agendamento

43

Agendamentos

GET /admin/v2/schedule/forecast

v2

11.3

Fazer previsões de todos os futuros trabalhos de execução para o período de tempo fornecido

44

Agendamentos

GET /admin/v1/schedules

v1

9.1

Encontrar agendamentos em um Server

45

Conexões do Server

GET /v3/serverDataConnections

v3

2021.4

Recuperar todos os registros de conexão de dados do Server

46

Conexões do Server

DELETE /v3/serverDataConnections/{dataConnectionId}

v3

2021.4

Excluir uma conexão de dados do Server

47

Conexões do Server

GET /v3/serverDataConnections/

{dataConnectionId}

v3

2021.4

Recuperar um registro de conexão de dados do Server

48

Conexões do Server

PUT /v3/serverDataConnections/

{dataConnectionId}

v3

2021.4

Atualizar uma conexão de dados do Server existente para alterar o nome da conexão

49

Conexões do Server

POST /v3/serverDataConnections//users

usuários

v3

2021.4

Adicionar um usuário a uma conexão de dados do Server existente

50

Conexões do Server

POST /v3/serverDataConnections//users

userGroups

v3

2021.4

Adicionar um grupo de usuários a uma conexão de dados do Server existente

51

Conexões do Server

DELETE /v3/serverDataConnections/

os usuários.

v3

2021.4

Remover um usuário de uma conexão de dados do Server existente

52

Conexões do Server

DELETE /v3/serverDataConnections/

userGroups

v3

2021.4

Remover um grupo de usuários de uma conexão de dados do Server existente

53

Conexões do Server

GET /admin/v1/serverdataconnections

v1

9.1

Retornar conexões de dados criadas em um Server privado

54

Assinaturas

GET /admin/v2/subscriptions

v2

11.3

Encontrar assinaturas em um Server

55

Assinaturas

GET /admin/v1/subscriptions

v1

9.1

Encontrar assinaturas em um Server

56

Alias do sistema

GET /admin/v1/systemdataconnections

v1

9.1

Retornar conexões de dados do sistema criadas no servidor onde o Alteryx Server está instalado

57

Grupos de usuários

GET /v3/usergroups

v3

2021.4

Obtenha todos os grupos de utilizadores do cliente

58

Grupos de usuários

POST /v3/usergroups

v3

2021.4

Crie um novo Grupo de Usuários Personalizado

59

Grupos de usuários

DELETE /v3/usergroups/{id}

v3

2021.4

Excluir um grupo de usuários personalizado do sistema

60

Grupos de usuários

GET /v3/usergroups/{id}

v3

2021.4

Recuperar um Grupo de Usuários Personalizado

61

Grupos de usuários

PUT /v3/usergroups/{id}

v3

2021.4

Atualizar o nome e a função de um grupo de usuários

62

Grupos de usuários

POST /v3/usergroups/{id}/users

v3

2021.4

Adicionar um ou mais usuários a um grupo de usuários

63

Grupos de usuários

DELETE /v3/usergroups/{userGroupId}/users/{userId}

v3

2021.4

Adicionar um grupo do Active Directory como membro de um grupo personalizado do Server.

64

Usuários

DELETE /v3/users/{id}

v3

2021.4

Excluir um usuário do sistema

65

Usuários

GET /v3/users/{id}

v3

2021.4

Recuperar um registro de usuário

66

Usuários

GET /v3/users/{id}/assets

v3

2021.4

Recuperar uma lista completa de ativos que um usuário possui

67

Usuários

GET /v3/users

v3

2021.4

Pesquisar registros de usuários

68

Usuários

POST /v3/users

v3

2021.4

Cria um novo registro de usuário

69

Usuários

POST /v3/users/{id}/deactivate

v3

2021.4

Desativar um usuário no sistema

70

Usuários

POST /v3/users/{id}/passwordReset

v3

2021.4

Envia um e-mail de redefinição de senha para o usuário especificado.

71

Usuários

PUT /v3/users/{id}

v3

2021.4

Atualizar um usuário existente

72

Usuários

GET /admin/v2/users

v2

11.3

Encontrar usuários em um Server

73

Usuários

GET /admin/v1/users

v1

9.1

Encontrar usuários em um Server

74

Fluxos de trabalho

GET /v3/workflows/{workflowId}

v3

2021.4

Recuperar um registro de fluxo de trabalho

75

Fluxos de trabalho

GET /v3/workflows/{workflowId}/package

v3

2022.3

2022.3

Baixar um pacote de fluxo de trabalho

76

Fluxos de trabalho

GET /v3/workflows/{workflowId}/questions

v3

2022.3

2022.3

Recuperar informações de perguntas para um fluxo de trabalho

77

Fluxos de trabalho

GET /v3/workflows/{workflowId}/jobs

v3

2022.3

2022.3

Recupere uma lista de trabalhos de um fluxo de trabalho existente.

78

Fluxos de trabalho

GET /v3/workflows

v3

2021.4

2022.3

Recuperar todos os registros de fluxo de trabalho

79

Fluxos de trabalho

POST /v3/workflows

v3

2021.4

2022.3

Carregar um novo fluxo de trabalho

80

Fluxos de trabalho

DELETE /v3/workflows/{workflowId}

v3

2021.4

Excluir um fluxo de trabalho específico

81

Fluxos de trabalho

PUT /v3/workflows/{workflowId}

v3

2021.4

Atualizar um fluxo de trabalho existente

82

Fluxos de trabalho

POST /user/v2/inputfiles

v2

2020.3

2020.3

Publicar um arquivo temporário a ser usado em uma execução subsequente de um fluxo de trabalho

83

Fluxos de trabalho

GET /admin/v2/workflows/all

v2

11.3

Retornar todos os fluxos de trabalho, opcionalmente filtrados por data

84

Fluxos de trabalho

GET /v1/workflows/{appId}/package

v1

9.1

9.1

Retornar o aplicativo solicitado

85

Fluxos de trabalho

GET /v1/workflows/{appId}/questions

v1

9.1

9.1

Obter as perguntas para o aplicativo analítico Alteryx fornecido

86

Fluxos de trabalho

GET /v1/workflows/subscription

v1

9.1

9.1

Encontrar fluxos de trabalho em uma assinatura

87

Fluxos de trabalho

GET /admin/v1/{appId}/package

v1

9.1

Retornar o aplicativo solicitado

88

Fluxos de trabalho

GET /admin/v1/workflows/migratable

v1

9.1

Encontrar fluxos de trabalho em um Server que foram marcados como prontos para migração

89

Fluxos de trabalho

GET /admin/v1/workflows/all

v1

9.1

Retornar todos os fluxos de trabalho, opcionalmente filtrados por data

90

Fluxos de trabalho

GET /admin/v1/workflows

v1

9.1

Encontrar fluxos de trabalho em um Server

91

Fluxos de trabalho

POST /admin/v1/workflows

v1

9.1

Publicar um YXZP no sistema

92

Fluxos de trabalho

PUT /admin/v1/workflows/migratable/{appId}

v1

9.1

Atualizar o sinalizador que indica se um aplicativo está pronto para migração