भाषाएँ
हर वह भाषा जिसमें संदेश भेजा जा सकता है। कोई पैरामीटर नहीं, कोई cursor नहीं, कोई scope नहीं।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
GET /languages
हर वह भाषा जिसमें संदेश भेजा जा सकता है। कोई पैरामीटर नहीं, कोई cursor नहीं, कोई scope नहीं।
इन्हें सूचीबद्ध करें
दो सौ पंक्तियाँ, पूरी की पूरी, एक ही प्रतिक्रिया में। इसे एक बार लाएँ और रख लें। जो क्लाइंट सूची को hardcode करता है या उसे OpenAPI दस्तावेज़ से खुरच कर निकालता है, वह जिस दिन एक पंक्ति जुड़ेगी उसी दिन पुराना पड़ जाएगा।
curl "$OE/languages" -H "$AUTH"{ "object": "list", "data": [ { "code": "en", "label": "English", "native": "English", "flag": "🇬🇧", "rtl": false }, { "code": "de", "label": "German", "native": "Deutsch", "flag": "🇩🇪", "rtl": false }, { "code": "ar", "label": "Arabic", "native": "العربية", "flag": "🇸🇦", "rtl": true }, { "code": "ja", "label": "Japanese", "native": "日本語", "flag": "🇯🇵", "rtl": false } ]}बाकी सबकी तरह कुंजी के पीछे और बिना किसी scope की ज़रूरत के: यह किसी के डेटा का नाम नहीं लेता, और किसी स्थिरांक की रखवाली करने वाला scope सिर्फ़ सहमति स्क्रीन को लंबा करता है।
यहाँ rtl हमेशा boolean होता है। सोलह पंक्तियाँ true हैं (अरबी, हिब्रू, फ़ारसी, उर्दू और बाकी), और इनमें से किसी में अनूदित बॉडी दाएँ से बाएँ रची जाती है।
एक भाषा
प्रतिक्रिया
codestring- BCP-47 कोड, और वही रूप जिसे संग्रहीत करना है। `translate.to` बाकी दोनों रूप भी स्वीकार करता है और हमेशा इसी से उत्तर देता है।
labelstring- अंग्रेज़ी नाम: "Brazilian Portuguese"। picker में मद्धिम दूसरी पंक्ति।
nativestring- भाषा ख़ुद को क्या कहती है: "Português (Brasil)"। इसे पहले दिखाएँ: अपनी भाषा ढूँढ़ने वाला व्यक्ति असल में यही शब्द ढूँढ़ रहा होता है।
flagstring- दो regional-indicator codepoints। मूल नाम के बगल में नज़र दौड़ाने की एक मदद, कभी अपने आप में पहचानकर्ता या लेबल नहीं। झंडा एक देश है, देश कोई भाषा नहीं है, और स्पेनिश उतनी ही स्पेन नहीं है जितनी अंग्रेज़ी इंग्लैंड की है।
rtlboolean- भाषा दाएँ से बाएँ लिखी जाती है या नहीं। हमेशा मौजूद, जबकि नीचे की तालिका false होने पर इसे छोड़ देती है।
क्रम ही उत्तर है
पंक्तियाँ picker के क्रम में आती हैं और उन्हें डिफ़ॉल्ट रूप से दोबारा क्रमबद्ध नहीं करना चाहिए: पहले वे भाषाएँ जिनमें लोगों को ईमेल मिलने की सबसे अधिक संभावना है, फिर क्षेत्रीय रूप, फिर बाकी क्षेत्र के अनुसार। अंग्रेज़ी नाम के वर्णक्रम में लगाने पर picker Abkhaz से खुलता है।
native, label और code तीनों पर एक साथ खोजें, और जब तक कोई टाइप न करे तब तक सूची जैसी आई है वैसी ही दिखाएँ। translate.to इन तीनों में से कोई भी लेता है, इसलिए जो picker code संग्रहीत करता है और तीनों पर खोजता है वह ऐसा मान नहीं बना सकता जिसे भेजाव अस्वीकार कर दे।