# API ஒன்றை ஏற்று கொள்ள

## கண்ணோட்டம்

APIs படைப்பாற்றல் வாய்ந்த இணைய மேம்பாட்டிற்கான முடிவில்லா வாய்ப்புகளை திறக்கின்றன! இந்த பயிற்சியில், நீங்கள் ஒரு வெளிப்புற 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. **இடைமுகத்தை திட்டமிடுங்கள்**: குறியீடு எழுதும் முன் நீட்டிப்பை வரைபடம் வரைந்து திருத்திக் கொள்ளவும்
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)

தயவுசெய்து பயனுள்ள மற்றும் படைப்பாற்றலான ஒன்றை உருவாக்குவதில் மகிழ்ச்சியடையுங்கள்! 🚀

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**ஒத்தி**:
இந்த ஆவணம் AI மொழிபெயர்ப்பு சேவை [Co-op Translator](https://github.com/Azure/co-op-translator) மூலம் மொழிபெயர்க்கப்பட்டுள்ளது. நாங்கள் ஒத்திசைவிற்காக முயற்சிக்கிறோம் என்றாலும், தானியங்கி மொழிபெயர்ப்புகளில் பிழைகளோ அல்லது தவறுகளோ இருக்க வாய்ப்பு உள்ளது என்பதை அறிந்திருக்கவும். அசல் ஆவணம் அதன் சொந்த மொழியிலேயே அதிகாரப்பூர்வ முறை என கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்நுட்பமான மனித மொழிபெயர்ப்பு பரிந்துரைக்கப்படுகிறது. இந்த மொழிபெயர்ப்பினைப் பயன்படுத்துவதில் ஏற்படும் தவறான புரிதல்கள் அல்லது தவறான விளக்கங்களுக்கு எங்கள் பொறுப்பில்லை.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->