MongoDB Data API
MongoDB Data API भाषा-विशिष्ट ड्राइवरों की आवश्यकता के बिना MongoDB डेटाबेस में डेटा को क्वेरी और अपडेट करने के लिए उपयोग किया जा सकता है।
भाषा ड्राइवरों का उपयोग तब किया जाना चाहिए जब संभव हो, लेकिन जब ड्राइवर उपलब्ध न हों या एप्लिकेशन के लिए ड्राइवर बहुत भारी हों तब MongoDB Data API उपयोगी होता है।
MongoDB Data API के साथ पढ़ना और लिखना
MongoDB Data API MongoDB Atlas डेटाबेस में डेटा पढ़ने और लिखने के लिए उपयोग किए जाने वाले पूर्व-निर्मित HTTPS endpoints का एक सेट है।
MongoDB Data API के साथ, आप MongoDB Atlas डेटाबेस में दस्तावेज़ बना सकते हैं, पढ़ सकते हैं, अपडेट कर सकते हैं, हटा सकते हैं या एकीकृत कर सकते हैं।
क्लस्टर कॉन्फ़िगरेशन
Data API का उपयोग करने के लिए, आपको पहले Atlas UI से कार्यक्षमता को सक्षम करना होगा।
पहुंच स्तर
डिफ़ॉल्ट रूप से, कोई पहुंच प्रदान नहीं की जाती है। Data API को प्रदान करने के लिए आप जिस पहुंच स्तर को चुनना चाहते हैं उसे चुनें। विकल्प: No Access, Read Only, Read and Write, or Custom Access.
Data API कुंजी
Data API के साथ प्रमाणित करने के लिए, आपको पहले एक Data API कुंजी बनानी होगी।
Create API Key पर क्लिक करें, कुंजी के लिए एक नाम दर्ज करें, फिर Generate API Key पर क्लिक करें।
महत्वपूर्ण नोट:
API कुंजी को कॉपी करें और इसे सुरक्षित स्थान पर सहेजें। इस कुंजी को फिर से देखने का कोई अन्य अवसर नहीं मिलेगा।
Data API अनुरोध भेजना
डेटाबेस को एक अनुरोध भेजने के लिए Data API का उपयोग किया जा सकता है।
अगले उदाहरण में, हम हमारे sample_mflix डेटाबेस के movies संग्रह में पहला दस्तावेज़ ढूंढने के लिए curl का उपयोग करेंगे। हमने इस नमूना डेटा को एकीकरण परिचय अनुभाग में लोड किया था।
इस उदाहरण को चलाने के लिए, आपको अपने App Id, API Key, और Cluster name की आवश्यकता होगी।
MongoDB Atlas UI में Data API पृष्ठ के URL Endpoint फ़ील्ड में आप अपना App Id देख सकते हैं।
उदाहरण
curl --location --request POST 'https://data.mongodb-api.com/app//endpoint/data/v1/action/findOne' \
--header 'Content-Type: application/json' \
--header 'Access-Control-Request-Headers: *' \
--header 'api-key: ' \
--data-raw '{
"dataSource":"",
"database":"sample_mflix",
"collection":"movies",
"projection": {"title": 1}
}'
Data API Endpoints
पिछले उदाहरण में, हमने अपने URL में findOne endpoint का उपयोग किया था।
Data API के साथ उपयोग करने के लिए कई endpoints उपलब्ध हैं।
सभी endpoints Base URL: https://data.mongodb-api.com/app//endpoint/data/v1/action/ से शुरू होते हैं
Find a Single Document
Endpoint: POST Base_URL/findOne
एक संग्रह में एक एकल दस्तावेज़ ढूंढने के लिए उपयोग किया जाता है
Request Body
{
"dataSource": "",
"database": "",
"collection": "",
"filter": ,
"projection":
}
Find Multiple Documents
Endpoint: POST Base_URL/find
एक संग्रह में कई दस्तावेज़ ढूंढने के लिए उपयोग किया जाता है
Request Body
{
"dataSource": "",
"database": "",
"collection": "",
"filter": ,
"projection": ,
"sort": ,
"limit": ,
"skip":
}
Insert a Single Document
Endpoint: POST Base_URL/insertOne
एक संग्रह में एक एकल दस्तावेज़ सम्मिलित करने के लिए उपयोग किया जाता है
Request Body
{
"dataSource": "",
"database": "",
"collection": "",
"document":
}
Insert Multiple Documents
Endpoint: POST Base_URL/insertMany
एक संग्रह में कई दस्तावेज़ सम्मिलित करने के लिए उपयोग किया जाता है
Request Body
{
"dataSource": "",
"database": "",
"collection": "",
"documents": [, , ...]
}
Update a Single Document
Endpoint: POST Base_URL/updateOne
Request Body
{
"dataSource": "",
"database": "",
"collection": "",
"filter": ,
"update": ,
"upsert": true|false
}
Update Multiple Documents
Endpoint: POST Base_URL/updateMany
Request Body
{
"dataSource": "",
"database": "",
"collection": "",
"filter": ,
"update": ,
"upsert": true|false
}
Delete a Single Document
Endpoint: POST Base_URL/deleteOne
Request Body
{
"dataSource": "",
"database": "",
"collection": "",
"filter":
}
Delete Multiple Documents
Endpoint: POST Base_URL/deleteMany
Request Body
{
"dataSource": "",
"database": "",
"collection": "",
"filter":
}
Aggregate Documents
Endpoint: POST Base_URL/aggregate
Request Body
{
"dataSource": "",
"database": "",
"collection": "",
"pipeline": [, ...]
}