<!--
CO_OP_TRANSLATOR_METADATA:
{
  "original_hash": "25b8d28b8531352d4eb67291fd7824c4",
  "translation_date": "2025-10-22T16:36:35+00:00",
  "source_file": "5-browser-extension/2-forms-browsers-local-storage/assignment.md",
  "language_code": "mr"
}
-->
# API स्वीकारा

## आढावा

API वेब विकासासाठी सर्जनशील शक्यता उघडतात! या असाइनमेंटमध्ये, तुम्ही एक बाह्य API निवडाल आणि एक ब्राउझर एक्सटेंशन तयार कराल जे वास्तविक समस्या सोडवते किंवा वापरकर्त्यांना उपयुक्त कार्यक्षमता प्रदान करते.

## सूचना

### चरण 1: तुमचा API निवडा
[फ्री पब्लिक API च्या निवडक यादी](https://github.com/public-apis/public-apis) मधून API निवडा. या श्रेणी विचारात घ्या:

**नवशिक्यांसाठी लोकप्रिय पर्याय:**
- **मनोरंजन**: [Dog CEO API](https://dog.ceo/dog-api/) यादृच्छिक कुत्र्यांच्या चित्रांसाठी
- **हवामान**: [OpenWeatherMap](https://openweathermap.org/api) सध्याच्या हवामानाच्या डेटासाठी
- **कोट्स**: [Quotable API](https://quotable.io/) प्रेरणादायक कोट्ससाठी
- **बातम्या**: [NewsAPI](https://newsapi.org/) सध्याच्या हेडलाइन्ससाठी
- **मजेदार तथ्य**: [Numbers API](http://numbersapi.com/) मनोरंजक संख्या तथ्यांसाठी

### चरण 2: तुमचे एक्सटेंशन प्लॅन करा
कोडिंग करण्यापूर्वी, या नियोजन प्रश्नांची उत्तरे द्या:
- तुमचे एक्सटेंशन कोणती समस्या सोडवते?
- तुमचा लक्ष्य वापरकर्ता कोण आहे?
- तुम्ही स्थानिक स्टोरेजमध्ये कोणते डेटा साठवणार आहात?
- API अपयश किंवा दर मर्यादा कशा हाताळाल?

### चरण 3: तुमचे एक्सटेंशन तयार करा
तुमच्या एक्सटेंशनमध्ये खालील गोष्टी असाव्यात:

**आवश्यक वैशिष्ट्ये:**
- आवश्यक API पॅरामीटर्ससाठी फॉर्म इनपुट्स
- योग्य एरर हँडलिंगसह API एकत्रीकरण
- वापरकर्ता प्राधान्ये किंवा API कींसाठी स्थानिक स्टोरेज
- स्वच्छ, प्रतिसादक्षम वापरकर्ता इंटरफेस
- लोडिंग स्टेट्स आणि वापरकर्ता फीडबॅक

**कोड आवश्यकता:**
- आधुनिक JavaScript (ES6+) वैशिष्ट्ये वापरा
- API कॉलसाठी async/await लागू करा
- try/catch ब्लॉक्ससह योग्य एरर हँडलिंग समाविष्ट करा
- तुमच्या कोडचे स्पष्टीकरण देणारे अर्थपूर्ण टिप्पण्या जोडा
- सुसंगत कोड फॉरमॅटिंगचे अनुसरण करा

### चरण 4: चाचणी करा आणि सुधारणा करा
- विविध इनपुटसह तुमचे एक्सटेंशन चाचणी करा
- एज केस हाताळा (इंटरनेट नाही, अवैध API प्रतिसाद)
- ब्राउझर रीस्टार्टनंतर तुमचे एक्सटेंशन कार्य करते याची खात्री करा
- वापरकर्ता-अनुकूल एरर संदेश जोडा

## बोनस आव्हाने

तुमचे एक्सटेंशन पुढील स्तरावर नेण्यासाठी:
- समृद्ध कार्यक्षमतेसाठी एकाधिक API एंडपॉइंट्स जोडा
- API कॉल कमी करण्यासाठी डेटा कॅशिंग लागू करा
- सामान्य क्रियांसाठी कीबोर्ड शॉर्टकट तयार करा
- डेटा निर्यात/आयात वैशिष्ट्ये जोडा
- वापरकर्ता सानुकूलन पर्याय लागू करा

## सबमिशन आवश्यकता

1. **कार्यरत ब्राउझर एक्सटेंशन** जे तुमच्या निवडलेल्या API सह यशस्वीरित्या एकत्रित होते
2. **README फाइल** ज्यामध्ये:
   - तुम्ही कोणता API निवडला आणि का
   - तुमचे एक्सटेंशन कसे स्थापित आणि वापरायचे
   - कोणत्याही API की किंवा सेटअप आवश्यक आहे
   - तुमच्या एक्सटेंशनच्या क्रियाशीलतेचे स्क्रीनशॉट
3. **स्वच्छ, टिप्पणी केलेला कोड** जो आधुनिक JavaScript पद्धतींचे अनुसरण करतो

## मूल्यांकन निकष

| निकष | उत्कृष्ट (90-100%) | प्रवीण (80-89%) | विकसित होत आहे (70-79%) | सुरुवातीचा (60-69%) |
|----------|---------------------|---------------------|---------------------|--------------------|
| **API एकत्रीकरण** | व्यापक एरर हँडलिंग आणि एज केस व्यवस्थापनासह निर्दोष API एकत्रीकरण | मूलभूत एरर हँडलिंगसह यशस्वी API एकत्रीकरण | API कार्य करते परंतु मर्यादित एरर हँडलिंग आहे | API एकत्रीकरणात महत्त्वपूर्ण समस्या आहेत |
| **कोड गुणवत्ता** | स्वच्छ, चांगल्या प्रकारे टिप्पणी केलेला आधुनिक JavaScript जो सर्वोत्तम पद्धतींचे अनुसरण करतो | पुरेश्या टिप्पण्या असलेल्या चांगल्या कोड संरचनेसह | कोड कार्य करते परंतु चांगल्या संघटनेची आवश्यकता आहे | खराब कोड गुणवत्ता आणि किमान टिप्पण्या |
| **वापरकर्ता अनुभव** | उत्कृष्ट लोडिंग स्टेट्स आणि वापरकर्ता फीडबॅकसह पॉलिश इंटरफेस | मूलभूत वापरकर्ता फीडबॅकसह चांगले इंटरफेस | पुरेसे कार्य करणारे मूलभूत इंटरफेस | गोंधळात टाकणाऱ्या इंटरफेससह खराब वापरकर्ता अनुभव |
| **स्थानिक स्टोरेज** | डेटा सत्यापन आणि व्यवस्थापनासह स्थानिक स्टोरेजचा परिष्कृत वापर | मुख्य वैशिष्ट्यांसाठी स्थानिक स्टोरेजची योग्य अंमलबजावणी | मूलभूत स्थानिक स्टोरेज अंमलबजावणी | स्थानिक स्टोरेजचा किमान किंवा चुकीचा वापर |
| **प्रलेखन** | सेटअप सूचना आणि स्क्रीनशॉटसह व्यापक README | बहुतेक आवश्यकता कव्हर करणारे चांगले प्रलेखन | काही तपशील गहाळ असलेले मूलभूत प्रलेखन | खराब किंवा गहाळ प्रलेखन |

## सुरुवात करण्याचे टिप्स

1. **सोप्या गोष्टींनी सुरुवात करा**: जटिल प्रमाणीकरण आवश्यक नसलेला API निवडा
2. **डॉक्युमेंट्स वाचा**: तुमच्या निवडलेल्या API च्या एंडपॉइंट्स आणि प्रतिसादांचे पूर्णपणे समजून घ्या
3. **तुमचा UI प्लॅन करा**: कोडिंग करण्यापूर्वी तुमच्या एक्सटेंशनचा इंटरफेस स्केच करा
4. **वारंवार चाचणी करा**: हळूहळू तयार करा आणि प्रत्येक वैशिष्ट्य जोडताना चाचणी करा
5. **एरर हाताळा**: नेहमी API कॉल अपयशी होऊ शकतात असे गृहीत धरा आणि त्यानुसार योजना करा

## संसाधने

- [ब्राउझर एक्सटेंशन प्रलेखन](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions)
- [Fetch API मार्गदर्शक](https://developer.mozilla.org/docs/Web/API/Fetch_API/Using_Fetch)
- [स्थानिक स्टोरेज ट्यूटोरियल](https://developer.mozilla.org/docs/Web/API/Window/localStorage)
- [JSON पार्सिंग आणि हाताळणी](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/JSON)

काहीतरी उपयुक्त आणि सर्जनशील तयार करण्यात मजा करा! 🚀

---

**अस्वीकरण**:  
हा दस्तऐवज AI भाषांतर सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) वापरून भाषांतरित करण्यात आला आहे. आम्ही अचूकतेसाठी प्रयत्नशील असलो तरी, कृपयास लक्षात ठेवा की स्वयंचलित भाषांतरे त्रुटी किंवा अचूकतेच्या अभावाने युक्त असू शकतात. मूळ भाषेतील दस्तऐवज हा अधिकृत स्रोत मानला जावा. महत्त्वाच्या माहितीसाठी, व्यावसायिक मानवी भाषांतराची शिफारस केली जाते. या भाषांतराचा वापर करून उद्भवलेल्या कोणत्याही गैरसमज किंवा चुकीच्या अर्थासाठी आम्ही जबाबदार राहणार नाही.