Inserir um documento

POSTAR /action/insertOne
Token de acesso E-mail e senha Api key Custom jwt

Insira um único documento em uma coleção.

corpo, corpo

  • dataSource string Obrigatório

    O nome de uma fonte de dados vinculada do MongoDB Atlas. Normalmente é "mongodb-atlas", embora isso possa mudar em seu aplicativo se você tiver escolhido outro nome ao criar a fonte de dados.

  • database string Obrigatório

    O nome de um banco de dados na fonte de dados especificada.

  • collection string Obrigatório

    O nome de uma collection no banco de dados especificado.

  • documento objeto Obrigatório

    Um documento para inserir na coleção.

corpo, corpo

  • dataSource string Obrigatório

    O nome de uma fonte de dados vinculada do MongoDB Atlas. Normalmente é "mongodb-atlas", embora isso possa mudar em seu aplicativo se você tiver escolhido outro nome ao criar a fonte de dados.

  • database string Obrigatório

    O nome de um banco de dados na fonte de dados especificada.

  • collection string Obrigatório

    O nome de uma collection no banco de dados especificado.

  • documento objeto Obrigatório

    Um documento para inserir na coleção.

Respostas

  • 200

    Inserido

    Ocultar atributo de resposta Mostrar atributo de resposta objeto
    • insertId

      O valor _id do documento inserido.

    Ocultar atributo de resposta Mostrar atributo de resposta objeto
    • insertId

      O valor _id do documento inserido.
  • 400 aplicação/json

    A solicitação estava malformada ou incompleta.

    Um dos seguintes:
    objeto ErrorNoAuthenticationSpecified objeto ErrorMissingAuthenticationParameter
  • 401 aplicação/json

    O usuário autenticado não tem permissão para acessar este endpoint.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto

    Indica que nenhum usuário correspondeu às credenciais de autenticação fornecidas.

    • Erro string

      Uma mensagem que descreve o erro.

      O valor é invalid session: error finding user for endpoint.

    • error_code string

      O tipo de erro.

      O valor é InvalidSession.

    • link string

      Um link para uma entrada de registro da operação com falha.
POST /ação/insertOne 
curl -s "https://data.mongodb-api.com/app/$CLIENT_APP_ID/endpoint/data/v1/action/insertOne" \
  -X POST \
  -H "apiKey: $API_KEY" \
  -H 'Content-Type: application/ejson' \
  -H "Accept: application/json" \
  -d '{
    "dataSource": "mongodb-atlas",
    "database": "learn-data-api",
    "collection": "tasks",
    "document": {
      "status": "open",
      "text": "Do the dishes"
    }
  }'
exemplo de solicitação 
{
  "database": "todo",
  "document": {
    "text": "Do the dishes",
    "status": "open${{ env.BUNDLED_SPEC_FILEPATH }}"
  },
  "collection": "tasks",
  "dataSource": "mongodb-atlas"
}
exemplo de solicitação 
{
  "database": "todo",
  "document": {
    "text": "Do the dishes",
    "status": "open"
  },
  "collection": "tasks",
  "dataSource": "mongodb-atlas"
}
Exemplos de resposta (200) 
{
  "insertedId": "6193504e1be4ab27791c8133"
}
Exemplos de resposta (200) 
{
  "insertedId": {
    "$oid": "6193504e1be4ab27791c8133"
  }
}
Exemplos de resposta (400) 
{
  "error": "no authentication methods were specified",
  "error_code": "InvalidParameter",
  "link": "string"
}
{
  "error": "must specify some form of authentication (either email+password, api-key, or jwt) in the request header or body",
  "error_code": "MissingParameter",
  "link": "string"
}
Exemplos de resposta (401) 
{
  "error": "invalid session: error finding user for endpoint",
  "error_code": "InvalidSession",
  "link": "string"
}