PUBLICAR /action/insertOne
Token de acceso Correo electrónico y contraseña Api key Custom jwt

Insertar un único documento en una colección.

Cuerpo

  • dataSource string Requerido

    El nombre de una fuente de datos de MongoDB Atlas vinculada. Suele ser "mongodb-atlas", aunque puede ser diferente en tu aplicación si elegiste un nombre diferente al crear la fuente de datos.

  • database string Requerido

    El nombre de una base de datos en la fuente de datos especificada.

  • Colección string Requerido

    El nombre de una colección en la base de datos especificada.

  • Documento Objeto Requerido

    Un documento para insertar en la colección.

Cuerpo

  • dataSource string Requerido

    El nombre de una fuente de datos de MongoDB Atlas vinculada. Suele ser "mongodb-atlas", aunque puede ser diferente en tu aplicación si elegiste un nombre diferente al crear la fuente de datos.

  • database string Requerido

    El nombre de una base de datos en la fuente de datos especificada.

  • Colección string Requerido

    El nombre de una colección en la base de datos especificada.

  • Documento Objeto Requerido

    Un documento para insertar en la colección.

Respuestas

  • 200

    Insertados

    Ocultar atributo de respuesta Mostrar atributo de respuesta Objeto
    • insertedId

      El valor _id del documento insertado.

    Ocultar atributo de respuesta Mostrar atributo de respuesta Objeto
    • insertedId

      El valor _id del documento insertado.
  • 400 aplicación/json

    La solicitud estaba mal formada o incompleta.

    Uno de:
    Objeto ErrorNoAuthenticationSpecified Objeto ErrorMissingAuthenticationParameter
  • 401 aplicación/json

    El usuario autenticado no tiene permiso para acceder a este punto final.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto

    Indica que ningún usuario coincidió con las credenciales de autenticación proporcionadas.

    • Error string

      Un mensaje que describe el error.

      El valor es invalid session: error finding user for endpoint.

    • error_code string

      El tipo de error.

      El valor es InvalidSession.

    • enlace string

      Un enlace a una entrada de registro de la operación fallida.
POST /action/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"
    }
  }'
Ejemplo de solicitud 
{
  "database": "todo",
  "document": {
    "text": "Do the dishes",
    "status": "open${{ env.BUNDLED_SPEC_FILEPATH }}"
  },
  "collection": "tasks",
  "dataSource": "mongodb-atlas"
}
Ejemplo de solicitud 
{
  "database": "todo",
  "document": {
    "text": "Do the dishes",
    "status": "open"
  },
  "collection": "tasks",
  "dataSource": "mongodb-atlas"
}
Ejemplos de respuestas (200) 
{
  "insertedId": "6193504e1be4ab27791c8133"
}
Ejemplos de respuestas (200) 
{
  "insertedId": {
    "$oid": "6193504e1be4ab27791c8133"
  }
}
Ejemplos de respuestas (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"
}
Ejemplos de respuestas (401) 
{
  "error": "invalid session: error finding user for endpoint",
  "error_code": "InvalidSession",
  "link": "string"
}