Pular para o conteúdo

Backendless

Backendless

Backendless é uma plataforma completa de backend-as-a-service (BaaS) que oferece funcionalidades escaláveis para aplicações móveis e web, incluindo autenticação de usuários, persistência de dados, armazenamento de arquivos e serviços de API personalizados. Com a integração no SquadOS, seus agentes podem criar e consultar objetos em banco de dados, gerenciar arquivos e diretórios, controlar sessões de usuários e publicar mensagens em canais em tempo real.

Esta ferramenta utiliza chave de API (API_KEY) para conectar.

Você vai precisar dos seguintes campos:

CampoObrigatórioDescrição
api_keySimChave de API da sua aplicação Backendless, disponível no Console em Manage → App Settings.
  1. Acesse backendless.com e faça login (ou crie uma conta gratuita).
  2. Selecione a aplicação desejada no painel do Console.
  3. Navegue até Manage → App Settings.
  4. Copie o valor de API Key (REST API key) exibido na página.
  1. Acesse Ferramentas no menu lateral (/admin/tools).
  2. Abra a aba Disponíveis e procure por Backendless.
  3. Clique no card para abrir o modal de detalhes e em Conectar.
  4. Você é levado para a página de conexão segura hospedada pela Composio, onde informa a chave de API obtida acima.
  5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

BACKENDLESS_COPY_FILE

Copia um arquivo ou diretório dentro do armazenamento de arquivos do Backendless. Use quando precisar duplicar arquivos para um novo local após verificar os caminhos de origem e destino.

NomeTipoObrigatórioDescrição
source_pathstringSimCaminho absoluto do arquivo ou diretório a copiar. Deve começar com barra (/) e apontar para um recurso existente.
target_pathstringSimCaminho do diretório de destino onde a origem será copiada. Deve começar com barra (/). Será criado automaticamente se não existir.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_CREATE_DIRECTORY

Cria um novo diretório no caminho especificado. Use quando precisar organizar arquivos em uma nova estrutura de pastas.

NomeTipoObrigatórioDescrição
user_tokenstringNãoToken de autorização para o serviço de arquivos seguro. Necessário apenas se a segurança estiver habilitada.
directory_pathstringSimCaminho completo do diretório a criar, sem barra inicial. Diretórios em múltiplos níveis serão criados automaticamente se não existirem.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_CREATE_HIVE

Cria um novo Hive. Use quando precisar provisionar um novo recurso Hive antes de realizar operações de Hive. Exemplo: criar um hive chamado groceryStore.

NomeTipoObrigatórioDescrição
hive_namestringSimNome do hive a criar. Deve ser seguro para URL, sem barras. Caracteres permitidos: letras, números, underline e hífen.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_CREATE_TIMER

Cria um novo timer com agendamento e código. Use quando precisar agendar tarefas recorrentes ou únicas para executar lógica server-side após confirmar os parâmetros.

NomeTipoObrigatórioDescrição
namestringSimNome único para o timer.
expireintegerNãoData/hora de expiração em milissegundos epoch Unix. O timer para após esse momento.
frequencyobjectSimConfiguração de agendamento e repetição do timer.
startDateintegerNãoData/hora de início em milissegundos epoch Unix. Padrão: agora, se omitido.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_DELETE_DIRECTORY

Exclui um diretório no caminho especificado no armazenamento de arquivos do Backendless. Use quando precisar remover pastas após confirmar o caminho.

NomeTipoObrigatórioDescrição
user_tokenstringNãoToken de autenticação do usuário opcional. Se fornecido, a operação de exclusão será executada sob as políticas de segurança desse usuário.
directory_pathstringSimCaminho relativo do diretório a excluir no armazenamento de arquivos. Não incluir barra inicial.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_DELETE_FILE

Exclui um arquivo do armazenamento de arquivos do Backendless no caminho especificado. Use quando precisar remover arquivos do armazenamento. A operação é permanente e não pode ser desfeita. Certifique-se de que o caminho do arquivo está correto antes de excluir.

NomeTipoObrigatórioDescrição
user_tokenstringNãoToken de usuário opcional obtido no login. Quando fornecido, a operação de exclusão é executada com as permissões e políticas de segurança do usuário autenticado.
relative_pathstringSimCaminho do arquivo no armazenamento do Backendless. Pode ser fornecido com ou sem barra inicial. Exemplos: txtfiles/test.txt, /txtfiles/test.txt ou test.txt.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_DELETE_TIMER

Exclui um timer do Backendless pelo seu nome único. Use para remover permanentemente um timer agendado da sua aplicação Backendless. O timer deve existir e você deve fornecer o nome exato. Uma vez excluído, as execuções agendadas do timer param imediatamente e não podem ser recuperadas. Nota: requer acesso à Console Management API do Backendless (disponível nos planos Plus ou Enterprise).

NomeTipoObrigatórioDescrição
namestringSimNome único do timer a excluir. Deve corresponder exatamente a um nome de timer existente.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_DIRECTORY_LISTING

Recupera uma listagem de arquivos e diretórios em um determinado caminho. Use quando precisar navegar ou filtrar diretórios do armazenamento de arquivos.

NomeTipoObrigatórioDescrição
subbooleanNãoSe verdadeiro, lista diretórios recursivamente.
pathstringSimCaminho do diretório a listar. Deve começar com /.
offsetintegerNãoÍndice do primeiro item a retornar para paginação.
patternstringNãoPadrão curinga para filtrar resultados; * corresponde a qualquer substring, ? corresponde a um único caractere.
pagesizeintegerNãoNúmero máximo de itens a retornar.
user_tokenstringNãoToken de usuário para políticas de segurança. Se fornecido, a requisição é executada com as permissões do usuário.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_GENERAL_OBJECT_RETRIEVAL

Recupera objetos de uma tabela Backendless especificada com filtragem, ordenação e paginação. Use após confirmar o nome da tabela e as opções de consulta. Exemplo: “Obter Users onde age > 30 ordenado por created desc”.

NomeTipoObrigatórioDescrição
propsstringNãoLista de propriedades a incluir, separadas por vírgula. Exemplo: name,email.
wherestringNãoCondição no estilo SQL para filtrar objetos. Exemplo: age > 25.
havingstringNãoCondição para filtrar grupos após agregação. Exemplo: COUNT(*) > 1.
offsetintegerNãoNúmero de objetos a pular antes de retornar os resultados. Padrão: 0.
sortBystringNãoLista de propriedades para ordenação, separadas por vírgula (adicione desc para decrescente). Exemplo: created desc.
groupBystringNãoLista de propriedades para agrupar, separadas por vírgula. Exemplo: department.
distinctstringNãoNome da coluna para retornar valores distintos. Exemplo: city.
pageSizeintegerNãoNúmero de objetos a retornar por página. Padrão: 10.
table_namestringSimNome da tabela de dados a consultar. Exemplo: Users.
user-tokenstringNãoToken de autenticação do usuário para aplicar políticas de segurança no nível do usuário.
excludePropsstringNãoLista de propriedades a excluir, separadas por vírgula. Exemplo: password.
loadRelationsstringNãoLista de propriedades relacionadas a incluir, separadas por vírgula. Exemplo: profile,address.
relationsDepthintegerNãoProfundidade dos objetos relacionados a incluir. Padrão: 1.
relationsPageSizeintegerNãoNúmero de objetos relacionados a retornar por página. Padrão: 10.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_GET_ALL_VALUES

Recupera todos os valores de um mapa em um Hive especificado. Use quando precisar buscar o conteúdo completo de um mapa Hive de uma só vez.

NomeTipoObrigatórioDescrição
map_namestringSimNome da chave que identifica o mapa.
hive_namestringSimNome do Hive onde o mapa está armazenado.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_GET_COUNTER_VALUE

Recupera o valor atual de um contador do Backendless. Use quando precisar inspecionar o valor de um contador atômico.

NomeTipoObrigatórioDescrição
user_tokenstringNãoToken de usuário opcional para aplicar políticas de segurança no nível do usuário.
counter_namestringSimNome do contador cujo valor deve ser recuperado.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_GET_FILE_COUNT

Obtém a contagem de arquivos em um diretório do Backendless. Use quando precisar determinar quantos itens correspondem a um filtro ou incluir subdiretórios.

NomeTipoObrigatórioDescrição
subbooleanNãoSe verdadeiro, inclui arquivos em subdiretórios recursivamente.
pathstringSimCaminho do diretório onde contar os arquivos. Deve começar com /.
patternstringNãoPadrão glob ou regex opcional para filtrar arquivos (prefixe com glob: ou regex:).
user_tokenstringNãoToken de usuário opcional para operações autenticadas. Aplica políticas de segurança do usuário se fornecido.
count_directoriesbooleanNãoSe verdadeiro, inclui diretórios na contagem também.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_GET_KEY_ITEMS

Recupera valores para uma chave especificada em uma lista (todos, único ou intervalo). Use quando precisar de elementos específicos ou da lista completa de uma chave Hive. Suporta recuperação por índice único, por intervalo ou lista completa.

NomeTipoObrigatórioDescrição
keystringSimNome da chave que identifica a lista a recuperar.
indexintegerNãoÍndice base zero para recuperar um único elemento. Mutuamente exclusivo com from_index e to_index.
to_indexintegerNãoÍndice final base zero para recuperação por intervalo. Deve ser fornecido junto com from_index.
hive_namestringSimNome do Hive onde a lista está armazenada.
from_indexintegerNãoÍndice inicial base zero para recuperação por intervalo. Deve ser fornecido junto com to_index.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_GET_TIMER

Recupera informações sobre um timer específico. Use quando precisar inspecionar o agendamento e os detalhes da próxima execução de um timer pelo nome.

NomeTipoObrigatórioDescrição
namestringSimNome do timer a recuperar.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_MAP_PUT

Define ou atualiza pares chave-valor em um mapa Hive. Use quando precisar adicionar ou atualizar múltiplas entradas em um mapa Hive.

NomeTipoObrigatórioDescrição
entriesobjectSimPares chave-valor a definir no mapa.
map_namestringSimNome da chave que identifica o mapa.
hive_namestringSimNome do Hive onde o mapa está armazenado.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_MOVE_FILE

Move um arquivo ou diretório dentro do armazenamento de arquivos do Backendless. Use quando precisar realocar recursos para um novo caminho após verificar origem e destino.

NomeTipoObrigatórioDescrição
source_pathstringSimCaminho absoluto do arquivo ou diretório a mover. Deve começar com barra (/) e apontar para um recurso existente.
target_pathstringSimCaminho do diretório de destino onde a origem será movida. Deve começar com barra (/). Será criado automaticamente se não existir.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_PUBLISH_MESSAGE

Publica uma mensagem em um canal de mensagens especificado. Use quando precisar enviar notificações ou eventos para assinantes após confirmar o canal e o payload.

NomeTipoObrigatórioDescrição
headersobjectNãoCabeçalhos adicionais de mensagem para filtragem de entrega.
messagestringSimConteúdo da mensagem a publicar; deve ser um tipo JSON válido.
publishAtintegerNãoTimestamp Unix em milissegundos indicando quando a mensagem deve ser entregue.
user_tokenstringNãoToken de usuário opcional para contexto de segurança; enviado como cabeçalho user-token.
publisherIdstringNãoIdentificador único do publicador da mensagem; opcional.
repeatEveryintegerNãoFrequência em segundos para entrega repetida.
channel_namestringSimNome do canal onde publicar a mensagem.
repeatExpiresAtintegerNãoTimestamp Unix em milissegundos indicando quando a repetição deve parar.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_RESET_COUNTER

Redefine um contador do Backendless de volta a zero. Use quando precisar reinicializar um contador antes de iniciar uma nova sequência.

NomeTipoObrigatórioDescrição
user_tokenstringNãoToken de usuário opcional para aplicar políticas de segurança no nível do usuário.
counter_namestringSimNome do contador a redefinir para zero.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_SET_COUNTER_VALUE

Define um contador do Backendless para um valor específico de forma condicional. Use quando precisar garantir que o contador só seja atualizado se corresponder a um valor esperado.

NomeTipoObrigatórioDescrição
expectedintegerSimO valor atual esperado do contador.
user_tokenstringNãoToken de usuário opcional para aplicar políticas de segurança no nível do usuário.
counter_namestringSimNome do contador a atualizar.
updatedvalueintegerSimO novo valor a definir se o contador atual for igual ao valor esperado.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_UPDATE_TIMER

Atualiza o agendamento ou o código de um timer existente. Use quando precisar modificar a configuração de um timer após recuperá-lo.

NomeTipoObrigatórioDescrição
codestringNãoCódigo atualizado a executar quando o timer disparar.
namestringSimNome do timer a atualizar.
expireintegerNãoNova data/hora de expiração em milissegundos epoch Unix.
frequencyobjectNãoConfiguração atualizada de agendamento e repetição do timer.
startDateintegerNãoNova data/hora de início em milissegundos epoch Unix.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_USER_DELETE

Exclui um usuário pelo ID. Use quando precisar remover uma conta de usuário após confirmar as permissões.

NomeTipoObrigatórioDescrição
user_idstringSimO ID único (objectId) do usuário a excluir.
user_tokenstringNãoToken de autenticação de usuário opcional. Se fornecido, a operação usa o contexto de segurança do usuário.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_USER_FIND

Recupera informações de um usuário pelo ID. Use quando precisar buscar detalhes de um usuário específico após ter o objectId.

NomeTipoObrigatórioDescrição
user_idstringSimO objectId único do usuário a recuperar.
user_tokenstringNãoToken de autenticação de usuário opcional. Se fornecido, a requisição usa o contexto de segurança do usuário.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_USER_GRANT_PERMISSION

Concede uma permissão a um usuário em um objeto de dados específico. Use quando precisar atribuir direitos de acesso precisos após verificar os IDs da tabela e do objeto. Exemplo: “Conceder permissão FIND a um usuário para um registro Person”.

NomeTipoObrigatórioDescrição
userstringSimID do objeto do usuário ao qual a permissão está sendo concedida.
object_idstringSimIdentificador único do objeto de dados cujas permissões serão modificadas.
permissionstringSimTipo de permissão a conceder. Valores: UPDATE, FIND, REMOVE, DESCRIBE, PERMISSION, LOAD_RELATIONS, ADD_RELATION, DELETE_RELATION, UPSERT, *. Use * para conceder todas as permissões.
table_namestringSimNome da tabela de dados que contém o objeto.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_USER_LOGIN

Faz login de um usuário registrado com identidade e senha. Use quando precisar autenticar um usuário antes de fazer requisições subsequentes. Exemplo: “Login de alice@wonderland.com com senha wonderland”.

NomeTipoObrigatórioDescrição
loginstringSimValor da propriedade marcada como identidade (ex.: e-mail).
passwordstringSimSenha do usuário (diferencia maiúsculas de minúsculas).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_USER_LOGOUT

Faz logout do usuário atualmente autenticado. Use quando precisar encerrar a sessão do usuário após as operações.

NomeTipoObrigatórioDescrição
user-tokenstringSimToken de sessão do usuário. Use como cabeçalho user-token para autenticar a requisição.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_USER_PASSWORD_RECOVERY

Inicia a recuperação de senha para um usuário. Use quando um usuário solicitar uma redefinição de senha após esquecê-la. Dispara um e-mail com instruções de recuperação.

NomeTipoObrigatórioDescrição
user_identitystringSimValor da propriedade marcada como identidade na tabela Users (por padrão, é o e-mail). Deve ser codificada em URL no caminho da requisição.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_USER_REGISTRATION

Registra um novo usuário com e-mail e senha. Use quando precisar criar uma conta de usuário ou converter uma conta de convidado em conta registrada após coletar as credenciais. Exemplo: registrar alice@wonderland.com com senha wonderland.

NomeTipoObrigatórioDescrição
emailstringSimEndereço de e-mail do usuário usado como identidade no Backendless.
objectIdstringNãoobjectId opcional de um usuário convidado a converter em usuário registrado.
passwordstringSimSenha para o novo usuário (diferencia maiúsculas de minúsculas).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_USER_REVOKE_PERMISSION

Revoga uma permissão de um usuário ou papel especificado em um objeto de dados específico. Use quando precisar negar uma operação concedida anteriormente para um usuário ou papel em um objeto de dados após verificar os IDs da tabela e do objeto.

NomeTipoObrigatórioDescrição
rolestringNãoNome do papel para o qual revogar a permissão. Ignorado se user for fornecido.
userstringNãoObjectId do usuário na tabela Users. Forneça para revogar para um usuário específico.
object_idstringSimIdentificador único do objeto de dados cujas permissões serão modificadas.
permissionstringSimTipo de permissão a revogar. Valores: UPDATE, FIND, REMOVE, DESCRIBE, PERMISSION, LOAD_RELATIONS, ADD_RELATION, DELETE_RELATION, UPSERT, *. Use * para revogar todas as permissões.
table_namestringSimNome da tabela de dados que contém o objeto.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_USER_UPDATE

Atualiza propriedades de um usuário Backendless existente. Use quando precisar modificar campos do perfil do usuário após o login. Exemplo: atualizar phoneNumber para 5551212.

NomeTipoObrigatórioDescrição
user_idstringSimObjectId do usuário a atualizar.
propertiesobjectSimPares chave-valor das propriedades do usuário a atualizar.
user_tokenstringNãoToken de sessão obtido em um login bem-sucedido. Se fornecido, a atualização será realizada sob a política de proprietário do usuário.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

BACKENDLESS_VALIDATE_USER_TOKEN

Valida um token de sessão de usuário. Use após obter um token no login para confirmar que a sessão está ativa.

NomeTipoObrigatórioDescrição
userTokenstringSimO token de sessão a validar, retornado pelo login do usuário.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.