Criar um App Services App

Autenticar um usuário do MongoDB Atlas

Use sua chave de API Admin do MongoDB Atlas para fazer login na CLI:

appservices login --api-key="<my api key>" --private-api-key="<my private api key>"

Execute o comando de criação de aplicativo

A CLI pode criar um aplicativo e copiar seus arquivos de configuração para um diretório local com um único comando. O comando solicita que você especifique o nome do aplicativo e o projeto Atlas que deve conter o aplicativo. Você pode configurar o comando com bandeiras ou interativamente.

appservices apps create

O comando também oferece suporte a sinalizadores adicionais que você pode incluir opcionalmente para personalizar seu aplicativo. A tabela a seguir lista sinalizadores comuns que você pode usar:

Obter um token de acesso à API de administrador

Chame o endpoint de autenticação do usuário administrador com seu par de chaves da API do MongoDB Atlas:

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/auth/providers/mongodb-cloud/login \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "username": "<Public API Key>",
    "apiKey": "<Private API Key>"
  }'

Se a autenticação for bem-sucedida, o corpo da resposta conterá um objeto JSON com um valor access_token :

{
  "access_token": "<access_token>",
  "refresh_token": "<refresh_token>",
  "user_id": "<user_id>",
  "device_id": "<device_id>"
}

O access_token concede acesso à App Services Admin API. Você deve incluí-lo como um token do portador no cabeçalho Authorization para todas as solicitações de API Admin.

Obter o ID do projeto

Cada App Services App pertence a um projeto do MongoDB Atlas .

Para criar um aplicativo, você precisa do ID do projeto (às vezes chamado de ID do grupo) do projeto MongoDB Atlas que contém o aplicativo. Você incluirá esse ID na URL das solicitações de API.

Criar um novo aplicativo

Você pode criar um novo aplicativo por meio do endpoint Criar um aplicativo .

Sua solicitação deve incluir:

• Um Authorization cabeçalho com seu token de acesso à API Admin como um token do portador.

• Um name para o novo aplicativo

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps \
  --header 'Authorization:  Bearer <access_token>' \
  --data '{ "name": "<App Name>" }'

Se quiser criar um aplicativo a partir de um modelo, você também deverá incluir o seguinte no corpo da solicitação:

• O campo template_id com um dos aplicativos de modelo disponíveis. Para obter uma lista de todos os aplicativos de modelo, consulte Aplicativos de modelo disponíveis.

• O campo data_source com informações sobre um Atlas cluster existente.

  curl -X POST \
    https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps \
    -H 'Authorization:  Bearer <access_token>' \
    -d '{
      "name": "<App Name>",
      "template_id": "<Template App Id>",
      "data_source": {
        "name": "mongodb-atlas",
        "type": "mongodb-atlas",
        "config": {
          "clusterName": "<Atlas Cluster Name>"
        }
      }
    }'

Se a sua aplicação for criada com sucesso, a API retornará uma resposta de 201 com informações sobre sua nova aplicação.