# APIని అంగీకరించండి

## అవలోకనం

APIs సృజనాత్మక వెబ్ అభివృద్ధికి ఎంతగానో అవకాశాలు తెరుస్తాయి! ఈ అసైన్‌మెంట్‌లో, మీరు ఒక బయటి APIని ఎంచుకుని, ఓ రియల్ సమస్యను పరిష్కరించగల లేదా వినియోగదారులకు విలువైన ఫంక్షనాలిటీని అందించే బ్రౌజర్ ఎక్స్‌టెన్షన్ నిర్మించాలి.

## సూచనాలు

### దశ 1: మీ APIను ఎంచుకోండి
ఈ కూర్పుచేసిన [ఉచిత పబ్లిక్ APIs జాబితా](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)
- [ఫెచ్ 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)

ఉపయోగకరమైన, సృజనాత్మకమైన ఏదైనా తయారు చేయడంలో సరదాగా ఉంటోంది! 🚀

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**వివరణా నోట్**:  
ఈ పత్రాన్ని AI అనువాద సేవ [Co-op Translator](https://github.com/Azure/co-op-translator) ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నిస్తున్నప్పటికీ, స్వయంచాలక అనువాదాలలో పొరపాట్లు లేదా తప్పిదాలు ఉండవచ్చు. మూల పత్రం native భాషలో ఉన్నది అధికారికమైన మూలం అని పరిగణించాలి. ముఖ్యమైన సమాచారానికి, ప్రత్యేకంగా మానవ అనువాదం చేయించుకోవడం సిఫార్సు చేయబడుతుంది. ఈ అనువాదం ఉపయోగంతో ఏర్పడిన ఏదైనా అపార్థాలు లేదా తప్పుదోవలకు మేము బాధ్యులేము.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->