Publicar uma operação como uma API no Jitterbit Integration Studio

Introdução

Esta página descreve como configurar e publicar uma API personalizada (para expor uma operação para consumo) no Integration Studio. A opção Publicar como uma API pode ser acessada no menu de ações de uma operação.

Alternativamente, APIs personalizadas podem ser criadas no API Manager APIs página.

APIs personalizadas (publicadas e rascunhos) são exibidas nestes locais:

• As APIs página do API Manager.
• A aba Recursos do painel do projeto para o projeto do Integration Studio associado à API personalizada.

Pré-requisitos

Para usar a opção Publicar como uma API no menu de ação da operação, estes pré-requisitos devem ser atendidos:

• A organização acessada deve ter uma assinatura do API Manager e ter as permissões de papel apropriadas e níveis de acesso ao ambiente. Para obter informações sobre como adicionar o API Manager à sua licença, entre em contato com seu Gerente de Sucesso do Cliente (CSM).

• A operação não deve ter nenhuma alteração não implantada.

Configurar a API

Após clicar na opção Publicar como uma API no menu de ações da operação, uma caixa de diálogo de configuração de API personalizada é aberta com estas configurações:

• Nome da API: Insira um nome para a API usar para fins de identificação interna. Por padrão, este campo é preenchido com o nome da operação.

• Raiz do serviço: O nome público da API a ser usada como parte do URL do serviço da API. Por padrão, este campo é preenchido com o nome da operação convertido para camel case. Este campo não permite espaços ou certos caracteres especiais. Usar caracteres especiais diferentes de sublinhado (_) não é recomendado. Estes caracteres especiais são permitidos:

  _ ~ ( ) $ ; / \ ? : @ = & ' ! * @ , + -

• Descrição: Insira uma descrição opcional para a API.

• Configurações adicionais: Clique para expandir as configurações adicionais:

  

  • Ambiente: Este campo é definido para o ambiente do projeto que está sendo acessado no momento e não pode ser alterado.

  • Número da versão: Insira uma versão opcional para usar como parte do URL do serviço da API. Este campo permite um máximo de 50 caracteres e não permite espaços ou certos caracteres especiais. O uso de caracteres especiais diferentes de um ponto final (.) ou um hífen (-) não é recomendado. Convenções de nomenclatura comuns incluem versões incrementais, como v1.0, v1.1, v1.2, ou usar uma data em que a API foi publicada, como 2023-09-21.

  • Tempo limite: Insira o número de segundos antes do tempo limite da API. O padrão é 30 segundos. O máximo é 180 segundos.

    Nota

    Esta configuração é independente da configuração Tempo limite de operação disponível na aba Opções da operação. As configurações de tempo limite de operação não são usadas para APIs do API Manager, a menos que um agente privado seja usado e o EnableAPITimeout configuração no arquivo de configuração do agente privado está habilitado.

  • Habilitar modo de depurar até: Selecione para habilitar o modo de depurar e habilite a inserção de uma data e hora correspondentes para a desativação do modo de depurar. O período máximo de ativação é de duas semanas. O modo de depuração permite o rastreamento completo de cada solicitação recebida por meio da URL de serviço da API. Quando habilitado, o sistema retém o conteúdo completo de cada solicitação e resposta da API por até 24 horas a partir do momento em que a chamada da API foi recebida e se aplica a todas as operações acionadas pela API.

  • Somente SSL: Esta opção é selecionada por padrão e requer o uso de criptografia SSL (recomendado).

  • Habilitar CORS: Selecione para habilitar Compartilhamento de Recursos de Origem Cruzada (CORS) (não recomendado).

  • Habilitar registro detalhado: Selecione para habilitar o registro detalhado. Os registros detalhados para APIs incluem dados de solicitação e resposta em cada registro de API para ajudar a monitorar dados de entrada e saída e facilitar a depuração. Como isso pode criar arquivos de log grandes, o registro detalhado é desabilitado por padrão.

• Nome do serviço: Insira um nome para o serviço da API. Por padrão, este campo é definido com o nome da operação.

• Projeto: O nome do projeto que está sendo acessado no momento.

• Operação: O nome da operação que está sendo exposta para consumo.

• Método: Selecione um dos métodos de solicitação a ser usado para a operação selecionada: ALL, CUSTOM, DELETE, GET, POST ou PUT. Selecionar ALL criará um método de solicitação separado. DELETE, GET, POST, e PUT métodos de solicitação para a operação (o CUSTOM método não incluído).

  Nota

  Serviços de API usando um CUSTOM o método não terá documentação OpenAPI gerada através do Portal Manager devido a uma limitação da especificação OpenAPI.

• Tipo de resposta: Selecione entre Meta final, Variável do sistema ou Sem resposta:

  • Destino Final: A resposta da API é o destino final da operação. Quando este tipo de resposta é selecionado, a operação deve ter (como destino final da cadeia de operação) uma atividade de Resposta da API do Integration Studio. Se qualquer outro destino final for usado, a resposta da API estará vazia.

  • Variável do Sistema: A resposta da API é definida em uma variável Jitterbit na operação. Quando este tipo de resposta é selecionado, a operação deve ter (como parte de uma cadeia de operação ) um script que defina a variável Jitterbit jitterbit.api.response igual à resposta que você deseja que a API retorne. Se esta variável não for definida, a resposta da API estará vazia.

  • Sem resposta: A resposta da API está em branco. Se a solicitação para executar a operação selecionada for aceita, a API retornará imediatamente uma resposta vazia com o código HTTP 202.

• Funções de Usuário: Use o menu para selecionar as funções da organização cujos membros terão acesso à API nas páginas do API Manager listadas abaixo. As funções disponíveis são aquelas definidas na página Gerenciamento de Usuários do Management Console, que são selecionadas por padrão.

  Isso determina o acesso a esta API específica a partir destas páginas:

  • APIs
  • Gerenciador do Portal, incluindo geração de documentação de API
  • Portal
  • Registros da API
  • Análise

  Acesso aos Perfis de Segurança e o acesso para consumir a API não são afetados por esta seleção. (O acesso para consumir uma API é controlado por perfis de segurança.)

  Quaisquer funções de usuário definidas com a permissão Admin sempre têm acesso total a todas as APIs e, portanto, não podem ser desmarcadas da seleção. (Na captura de tela de exemplo mostrada acima, a papel Administrador não pode ser desmarcada por esse motivo.)

• Perfis de segurança: Selecione o método para fornecer um perfil de segurança para restringir o acesso para consumo da API (opcional):

  • Usar perfil existente: Quando selecionado, use o menu Perfil para selecionar um perfil de segurança existente.

  • Criar novo perfil: Quando selecionado, campos adicionais ficam disponíveis para configurar um novo perfil de segurança (consulte Configuração do perfil de segurança):

    

• Perfil: Visível quando Usar perfil existente estiver selecionado. Use o menu para selecionar um perfil de segurança existente para restringir o acesso ao consumo da API.

• Publicar: Salva a API no status Publicada. A API fica ativa e acessível em até cinco minutos. Uma API publicada conta como uma URL de API na sua franquia de assinatura do Harmony. Você pode acessar a API publicada no API Manager APIs página.

• Salvar rascunho: Salva a API no status Rascunho e pode ser acessada no API Manager APIs página. Uma API de rascunho não conta como uma URL de API na sua franquia de assinatura do Harmony. Você pode acessar e concluir a configuração da API de rascunho no API Manager APIs página.

• Cancelar: Fecha a caixa de diálogo sem salvar.