Zyla API Hub पर हर API एक ही क्वालिटी रूल्स से गुज़रती है, चाहे वह कैसे भी पब्लिश हुई हो: web wizard, कोई import या AI एजेंट्स द्वारा इस्तेमाल होने वाला Listings API। ये rules इसलिए हैं ताकि ग्राहक जो खरीदें उस पर भरोसा कर सकें और अच्छी APIs ढूंढना आसान हो। जो listings इन्हें पूरा नहीं करती वे पब्लिश नहीं होती, और एरर बताती है कि क्या बदलना है।
अंग्रेज़ी में लिखें, हम इसका अनुवाद करते हैं
अपनी listing अंग्रेज़ी में लिखें: नाम, descriptions, endpoints और FAQs। Zyla API Hub इसे अपने आप हब की बाकी भाषाओं (स्पेनिश, पोर्तुगीज़, हिंदी और चीनी) में translate कर देता है, ताकि आपकी API उन सभी में ग्राहकों तक पहुंचे। जब आप अंग्रेज़ी text एडिट करते हैं, तो translations भी अपडेट हो जाते हैं।
नाम
- एक साफ़ नाम, अंग्रेज़ी में, जो बताए कि API क्या करती है और जिसमें "API" शब्द शामिल हो, जैसे "Weather Forecast API"।
- हब पर unique, और अधिकतम 50 characters।
- यह एक तैयार प्रोडक्ट जैसा दिखना चाहिए। जो नाम किसी test, demo, copy, placeholder या किसी दूसरी API की duplicate जैसे लगते हैं, वे स्वीकार नहीं किए जाते।
- Brands और platforms पूरे नाम में लिखें (Instagram, न कि IG) और दूसरे API marketplaces के नाम इस्तेमाल न करें।
Descriptions
- अंग्रेज़ी में, यह बताते हुए कि API क्या करती है और क्या लौटाती है। Short description में कम से कम 50 characters होने चाहिए।
- नाम और endpoints के साथ consistent।
- जानकारीपूर्ण, promotional नहीं: कोई advertising, prices, discounts या ऐसे claims नहीं जिन्हें आप साबित न कर सकें।
सब कुछ हब पर रखें
Zyla API Hub आपके और आपके ग्राहकों के बीच का intermediary है: discovery, billing, keys, limits और support सब हब पर होता है। इस तरह हम दोनों पक्षों को क्वालिटी की गारंटी देते हैं।
- listing में कहीं भी email addresses, websites, phone numbers, social profiles या कोई और contact details न डालें: नाम, descriptions, endpoints, FAQs या example responses में।
- ग्राहकों को हब के बाहर आपसे contact करने या खरीदने के लिए न बुलाएं।
- ग्राहकों के सवाल Zyla के ज़रिए आप तक पहुंचते हैं।
Endpoints
- एक साफ़ नाम और यह बताने वाला description कि endpoint क्या करता है।
- एक valid method और base URL, और हर parameter का type और एक छोटा description।
- एक असली example response, ताकि ग्राहक खरीदने से पहले देख सकें कि उन्हें क्या मिलेगा।
Plans
- कम से कम तीन paid monthly plans, जहाँ ज़्यादा महंगे plan में हमेशा ज़्यादा calls शामिल हों।
- प्रति मिनट 60 से 240 requests के बीच rate limits।
आप कितनी नई APIs बना सकते हैं
कैटलॉग को उपयोगी बनाए रखने और कम-क्वालिटी listings की बाढ़ से बचने के लिए, हर account के पास नई APIs का एक quota होता है। यह quota आपके track record के साथ बढ़ता है।
| Account | नई APIs | Linked APIs (आपकी किसी API के variants) |
|---|---|---|
| अभी तक कोई paid sale नहीं | 24 घंटे में 5 और 7 दिन में 20 | 24 घंटे में 20 |
| कम से कम एक paid subscription | 24 घंटे में 20 | 24 घंटे में 60 |
- Windows rolling हैं, और deleted APIs फिर भी गिनी जाती हैं। अपनी मौजूदा APIs को एडिट करना कभी नहीं गिना जाता।
- Quota से ऊपर जाने पर, नई APIs एक ऐसे message के साथ रिजेक्ट होती हैं जो बताता है कि आप और कब बना सकते हैं (Listings API
429जवाब देता है)। आपका account और आपकी मौजूदा APIs प्रभावित नहीं होती।
एक बड़े, legitimate कैटलॉग के लिए ज़्यादा लिमिट चाहिए? हमारी टीम को लिखें।
Review
जब आप सेव करते हैं तो automatic checks चलते हैं, और Zyla टीम हब पर APIs को रिव्यू करती है। जो API इन rules या नियम और शर्तें को फॉलो नहीं करती, भले ही वह पब्लिश हो गई हो, उसे रिजेक्ट, hide या remove किया जा सकता है।