La API de datos ha llegado al final de su ciclo de vida y MongoDB ya no la soporta activamente. Esta página se mantiene únicamente como referencia histórica. Para obtener más información, consulte Obsolescencia de la API de datos y los puntos finales HTTPS.
La API de datos era un servicio administrado que permitía trabajar de forma segura con los datos almacenados en Atlas mediante solicitudes HTTPS estándar. La API de datos no es una conexión directa a la base de datos. En cambio, es un servicio de middleware completamente administrado que se ubica entre el clúster y los clientes que envían solicitudes.
Puede utilizar la API de datos para conectarse a MongoDB Atlas desde cualquier plataforma que admita HTTPS, incluidas:
Navegadores web
servidores web
Canalizaciones de CI/CD
Aplicaciones móviles
Dispositivos de Internet de las cosas
No es necesario instalar controladores de base de datos ni bibliotecas para trabajar con la API de datos. En su lugar, se envían solicitudes HTTPS estándar como la siguiente:
curl -s "https://data.mongodb-api.com/app/myapp-abcde/endpoint/data/v1/action/insertOne" \ -X POST \ -H "Content-Type: application/ejson" \ -H "Accept: application/json" \ -H "apiKey: TpqAKQgvhZE4r6AOzpVydJ9a3tB1BLMrgDzLlBLbihKNDzSJWTAHMVbsMoIOpnM6" \ -d '{ "dataSource": "mongodb-atlas", "database": "learn-data-api", "collection": "hello", "document": { "text": "Hello, world!" } }'
{ "insertedId": "63dc56ac74ddb86ed3eb8474" }
Puntos finales [Fin de la vida útil]
La API de datos admitía dos tipos de puntos finales:
Lospuntos de conexión de la API de datos se generaban automáticamente y cada uno representaba una operación de MongoDB. Podía usarlos para crear, leer, actualizar, eliminar y agregar documentos en una fuente de datos de MongoDB.
Los puntos de conexión personalizados eran rutas de API específicas de la aplicación, gestionadas por las funciones de Atlas que usted crea. Puede usar puntos de conexión personalizados para definir operaciones que se adapten específicamente a su caso de uso. Por ejemplo, podría crear un punto de conexión que ejecute una agregación predefinida o que se integre con un servicio de webhook externo.
Cómo funcionaba la API de datos [Fin de la vida útil]
Las solicitudes de API de datos pueden parecerse a las operaciones de bases de datos tradicionales, como
find o insertOne, pero la API de datos no ofrece una conexión directa a su base de datos. En su lugar, la API de datos añade comprobaciones adicionales de autenticación, autorización y corrección para garantizar que solo se acceda o modifique a sus datos de la forma que usted permita. Esto le permite acceder de forma segura a los datos en Atlas desde clientes potencialmente vulnerables, como las aplicaciones web.
Para cada solicitud entrante, la API de datos:
Autenticó al usuario que realiza la llamada. Esto puede implicar validar un token de acceso, iniciar sesión con las credenciales del encabezado o asignar directamente un usuario específico en tiempo de ejecución según su configuración.
Solicitud autorizada. Esto garantiza que el usuario haya enviado una solicitud correctamente formada y que tenga permiso para realizar la operación solicitada en base a tu esquema de autorización de endpoints.
Se ejecutó la operación solicitada. Esto podría implicar leer o escribir datos en Atlas con un punto final generado o invocar una función personalizada que usted creó.
Para las solicitudes que leen o escriben datos en Atlas, la API de datos también aplica las reglas de control de acceso y los esquemas de documentos definidos en la aplicación. Esto significa que los usuarios solo pueden acceder a los datos que tienen permitido leer y escribir. Las solicitudes fallan si incluyen una operación de escritura no válida.
Se devolvió una respuesta HTTPS al llamador. La respuesta incluyó el resultado de una operación generada por un endpoint o cualquier dato que devuelvas de un endpoint personalizado. En la solicitud, puedes elegir recibir la respuesta en uno de los siguientes formatos: JSON o EJSON.
Cuándo utilizar la API de datos [Fin de vida útil]
Para aplicaciones de servidor, y especialmente para casos de uso con alta carga y sensibles a la latencia, recomendamos conectarse directamente a Atlas con un controlador de MongoDB. Las operaciones realizadas a través de un punto final de la API de datos tardan más en completarse que las operaciones de MongoDB correspondientes realizadas a través de un controlador. Además, los controladores ofrecen mayor flexibilidad y control sobre la ejecución de las operaciones. Para obtener más información, consulte la documentación de los controladores de MongoDB.
Ya no se puede usar la API de datos. Antes de que quedara obsoleta, recomendábamos usarla en los siguientes casos:
Desea ejecutar operaciones de MongoDB desde una aplicación web u otro cliente en el que no puede confiar.
No puede o no desea administrar un controlador de MongoDB en su entorno de servidor. Por ejemplo, algunos entornos de computación perimetral no admiten controladores de bases de datos ni agrupación de conexiones.
Desea desarrollar una nueva función y prefiere una solución flexible para trabajar primero en el lado del cliente antes de crear y refinar posteriormente la capa de API.
Desea integrar el acceso a los datos de Atlas en una puerta de enlace API federada.
Desea conectarse a App Services desde un entorno que actualmente no es compatible con un SDK de dispositivo Atlas y no desea utilizar un controlador para conectarse a través del protocolo de cable.
Restricciones [Fin de la vida útil]
Las siguientes restricciones se aplican a las solicitudes y respuestas de la API de datos:
Las solicitudes expirarán después de 300 segundos de tiempo de ejecución.
Las cargas útiles de respuesta de la API de datos están limitadas a un tamaño de 350 MB.