Building Shopify Apps: A Developer's Guide to the Shopify App Ecosystem

शॉपिफाई ऐप स्टोर 10,000 से अधिक ऐप्स होस्ट करता है और डेवलपर्स के लिए अरबों का राजस्व उत्पन्न करता है। चाहे आप किसी एक व्यापारी के लिए एक कस्टम ऐप बना रहे हों या हजारों स्टोर्स के लिए एक सार्वजनिक ऐप, Shopify के ऐप आर्किटेक्चर, एपीआई और इकोसिस्टम को समझना आवश्यक है। यह मार्गदर्शिका उन सभी चीज़ों को शामिल करती है जो डेवलपर्स को 2026 में शॉपिफाई ऐप्स बनाने, लॉन्च करने और स्केल करने के लिए जानने की आवश्यकता है।

प्रश्न: आप किस प्रकार के Shopify ऐप्स बना सकते हैं?

Shopify ऐप्स तीन प्रकार के होते हैं: किसी भी व्यापारी के इंस्टॉल करने के लिए Shopify ऐप स्टोर पर सूचीबद्ध सार्वजनिक ऐप्स, किसी एक विशिष्ट स्टोर के लिए बनाए गए कस्टम ऐप्स, और विकास और परीक्षण के दौरान उपयोग किए जाने वाले ड्राफ्ट ऐप्स। सार्वजनिक ऐप्स Shopify की समीक्षा प्रक्रिया से गुजरते हैं, जबकि कस्टम ऐप्स सीधे स्टोर के व्यवस्थापक के माध्यम से इंस्टॉल किए जाते हैं।

ऐप प्रकार समझाए गए

सार्वजनिक ऐप्स

सार्वजनिक ऐप्स Shopify ऐप स्टोर पर सूचीबद्ध हैं और इन्हें किसी भी Shopify व्यापारी द्वारा इंस्टॉल किया जा सकता है। वे प्रमाणीकरण के लिए OAuth का उपयोग करते हैं और उन्हें Shopify के ऐप समीक्षा दिशानिर्देशों का पालन करना होगा।

विशेषताएँ:

• सभी 4.8+ मिलियन शॉपिफाई स्टोर्स के लिए उपलब्ध
• सदस्यता, उपयोग शुल्क, या एकमुश्त खरीदारी के माध्यम से राजस्व
• Shopify की ऐप समीक्षा प्रक्रिया को पास करना होगा
• व्यापारी प्रमाणीकरण के लिए OAuth 2.0 का उपयोग करें
• Shopify की ऐप स्टोर नीतियों और गुणवत्ता मानकों के अधीन

कस्टम ऐप्स

कस्टम ऐप्स एक ही स्टोर के लिए बनाए जाते हैं और ऐप स्टोर समीक्षा प्रक्रिया से नहीं गुजरते हैं। वे सीधे स्टोर के व्यवस्थापक पैनल के माध्यम से स्थापित किए जाते हैं।

विशेषताएँ:

• एक विशिष्ट व्यापारी के लिए निर्मित
• किसी ऐप स्टोर सूची की आवश्यकता नहीं है
• Shopify एडमिन में एक्सेस टोकन जनरेट किए गए
• कोई OAuth प्रवाह की आवश्यकता नहीं है
• विशिष्ट व्यावसायिक तर्क और एकीकरण के लिए आदर्श

ड्राफ्ट ऐप्स

ड्राफ्ट ऐप्स का उपयोग विकास के दौरान किया जाता है। वे सार्वजनिक ऐप्स की तरह काम करते हैं लेकिन केवल डेवलपमेंट स्टोर्स पर ही इंस्टॉल किए जा सकते हैं। ऐप स्टोर में सबमिट करने पर वे सार्वजनिक ऐप्स में परिवर्तित हो जाते हैं।

अपना विकास परिवेश स्थापित करना

शॉपिफाई सीएलआई

शॉपिफाई सीएलआई ऐप डेवलपमेंट के लिए आधिकारिक कमांड-लाइन टूल है। यह परियोजनाओं का निर्माण करता है, विकास स्टोरों का प्रबंधन करता है, और ऐप परिनियोजन को संभालता है।

आरंभ करना:

1. Node.js 18+ और npm स्थापित करें
2. शॉपिफाई सीएलआई स्थापित करें: npm install -g @shopify/cli @shopify/app
3. एक नया ऐप बनाएं: shopify app init
4. अपना ढांचा चुनें (रीमिक्स डिफ़ॉल्ट और अनुशंसित विकल्प है)
5. विकास प्रारंभ करें: shopify app dev

सीएलआई स्वचालित रूप से स्थानीय विकास के लिए एनग्रोक सुरंगें स्थापित करता है, ऐप प्रमाणीकरण का प्रबंधन करता है, और हॉट मॉड्यूल पुनः लोडिंग प्रदान करता है।

विकास भंडार

अपने शॉपिफाई पार्टनर डैशबोर्ड के माध्यम से एक निःशुल्क विकास स्टोर बनाएं। डेवलपमेंट स्टोर्स के पास सभी Shopify सुविधाओं तक पूर्ण पहुंच है और उन्हें भुगतान योजना की आवश्यकता नहीं है। आप परीक्षण के लिए असीमित विकास स्टोर बना सकते हैं।

शॉपिफाई एपीआई

Shopify विभिन्न उपयोग मामलों के लिए कई एपीआई प्रदान करता है:

एडमिन एपीआई

एडमिन एपीआई स्टोर डेटा के प्रबंधन के लिए प्राथमिक इंटरफ़ेस है। यह उत्पादों, ऑर्डर, ग्राहकों, इन्वेंट्री, पूर्ति और बहुत कुछ तक पहुंच प्रदान करता है।

ग्राफक्यूएल बनाम आरईएसटी:

शॉपिफाई नए विकास के लिए ग्राफक्यूएल एडमिन एपीआई की सिफारिश करता है। लाभों में शामिल हैं:

• ठीक उसी फ़ील्ड का अनुरोध करें जिसकी आपको आवश्यकता है (कोई अति-प्राप्ति नहीं)
• एक ही अनुरोध में संबंधित संसाधन प्राप्त करें
• आत्मनिरीक्षण के साथ सशक्त रूप से टाइप की गई स्कीमा
• बेहतर दर सीमा उपयोग (अनुरोध-आधारित के बजाय लागत-आधारित)

ग्राफक्यूएल उदाहरण--उत्पाद प्राप्त करना:

query {
  products(first: 10) {
    edges {
      node {
        id
        title
        variants(first: 5) {
          edges {
            node {
              price
              inventoryQuantity
            }
          }
        }
      }
    }
  }
}

दर सीमा:

• ग्राफक्यूएल एडमिन एपीआई: प्रति सेकंड 1,000 लागत अंक (प्रत्येक फ़ील्ड की एक लागत होती है)
• रेस्ट एडमिन एपीआई: 40 अनुरोध प्रति सेकंड (बेसिक/शॉपिफाई), 80 (उन्नत/प्लस)
• स्टोरफ्रंट एपीआई: प्रति सेकंड 100 लागत अंक

स्टोरफ्रंट एपीआई

स्टोरफ्रंट एपीआई ग्राहक-सामना के अनुभवों के लिए डिज़ाइन किया गया है। यह उत्पादों, संग्रहों और कार्ट कार्यक्षमता तक अप्रमाणित पहुंच प्रदान करता है। निर्माण करते समय इसका उपयोग करें:

• कस्टम स्टोरफ्रंट (नेतृत्वहीन वाणिज्य)
• मोबाइल ऐप्स
• बाहरी वेबसाइटों पर एम्बेडेड बटन खरीदें
• उत्पाद अनुशंसा विजेट

वेबहुक

किसी व्यापारी के स्टोर में घटनाएँ घटित होने पर वेबहुक आपके ऐप को सूचित करता है। जब डेटा बदलता है तो एपीआई पोलिंग के बजाय, Shopify आपके एंडपॉइंट पर HTTP POST अनुरोध भेजता है।

अधिकांश ऐप्स के लिए आवश्यक वेबहुक:

• orders/create -- नया ऑर्डर दिया गया
• orders/updated -- ऑर्डर स्थिति बदल गई
• products/update -- उत्पाद डेटा संशोधित
• products/delete -- उत्पाद हटा दिया गया
• app/uninstalled -- व्यापारी ने आपका ऐप अनइंस्टॉल कर दिया
• shop/update -- स्टोर सेटिंग बदल गई

वेबहुक सर्वोत्तम अभ्यास:

1. जल्दी जवाब दें -- 5 सेकंड के भीतर 200 स्थिति लौटाएँ; डेटा को अतुल्यकालिक रूप से संसाधित करें
2. डुप्लिकेट संभालें -- Shopify एक ही वेबहुक को कई बार भेज सकता है; निष्क्रियता लागू करें
3. हस्ताक्षर सत्यापित करें -- प्रामाणिकता की पुष्टि करने के लिए X-Shopify-Hmac-SHA256 हेडर को सत्यापित करें
4. पुनःप्रयास तर्क लागू करें -- यदि आपका समापन बिंदु विफल हो जाता है, तो Shopify 48 घंटों में 19 बार तक पुनःप्रयास करता है
5. अनिवार्य वेबहुक का उपयोग करें -- अनुपालन के लिए app/uninstalled, customers/data_request, customers/redact, और shop/redact पंजीकृत करें

ऐप ब्रिज और पोलारिस के साथ ऐप यूआई का निर्माण

शॉपिफाई ऐप ब्रिज

ऐप ब्रिज आपके ऐप के यूआई को शॉपिफाई एडमिन के अंदर प्रस्तुत करने में सक्षम बनाता है। यह प्रदान करता है:

• Shopify के एडमिन साइडबार के साथ नेविगेशन एकीकरण
• मॉडल संवाद, टोस्ट सूचनाएं और लोडिंग बार
• उत्पादों, संग्रहों और ग्राहकों के चयन के लिए संसाधन पिकर
• प्राथमिक और द्वितीयक क्रियाओं के साथ शीर्षक पट्टी

पोलारिस डिज़ाइन सिस्टम

पोलारिस शॉपिफाई की रिएक्ट घटक लाइब्रेरी है। यह पूर्व-निर्मित UI घटक प्रदान करता है जो Shopify की व्यवस्थापक डिज़ाइन भाषा से मेल खाता है:

• फॉर्म, बटन और इनपुट फ़ील्ड
• डेटा तालिकाएँ और संसाधन सूचियाँ
• कार्ड, बैनर और लेआउट घटक
• दिनांक चयनकर्ता, फ़िल्टर और पृष्ठांकन

पोलारिस का उपयोग यह सुनिश्चित करता है कि आपका ऐप शॉपिफाई एडमिन के भीतर मूल लगता है और डिज़ाइन समीक्षा पास करता है।

शॉपिफाई फ़ंक्शंस

Shopify फ़ंक्शंस आपको WebAssembly (Wasm) का उपयोग करके Shopify के बुनियादी ढांचे पर कस्टम बिजनेस लॉजिक चलाने की अनुमति देता है। वे लीगेसी स्क्रिप्ट संपादक स्क्रिप्ट को प्रतिस्थापित करते हैं और वाणिज्य प्रवाह में प्रमुख बिंदुओं पर चलते हैं:

• डिस्काउंट फ़ंक्शंस - कस्टम डिस्काउंट लॉजिक (बीओजीओ, स्तरीय मूल्य निर्धारण, वॉल्यूम छूट)
• शिपिंग कार्य--कस्टम शिपिंग दरें और डिलीवरी विकल्प
• भुगतान कार्य -- चेकआउट के समय भुगतान विधियों को छुपाएं या पुनः व्यवस्थित करें
• सत्यापन कार्य--कस्टम कार्ट और चेकआउट सत्यापन नियम
• पूर्ति कार्य -- कस्टम पूर्ति स्थान रूटिंग

फ़ंक्शंस 5ms के अंदर निष्पादित होते हैं और Shopify के सर्वर पर चलते हैं, यह सुनिश्चित करते हुए कि वे स्टोरफ्रंट तकनीक (लिक्विड, हाइड्रोजन, या थर्ड-पार्टी) की परवाह किए बिना काम करते हैं।

ऐप समीक्षा प्रक्रिया

ऐप स्टोर पर सूचीबद्ध होने से पहले सार्वजनिक ऐप्स को Shopify की समीक्षा पास करनी होगी। समीक्षा का मूल्यांकन है:

तकनीकी आवश्यकताएँ:

• ऐप को Shopify API के नवीनतम संस्करण का उपयोग करना होगा
• सही दायरे के साथ उचित OAuth कार्यान्वयन
• सभी समापन बिंदुओं के लिए HTTPS
• जीडीपीआर अनुपालन के लिए अनिवार्य वेबहुक हैंडलर
• त्रुटि प्रबंधन और सुंदर गिरावट

उपयोगकर्ता अनुभव आवश्यकताएँ:

• एडमिन यूआई के लिए पोलारिस घटकों का उपयोग करें
• स्पष्ट ऑनबोर्डिंग और सेटअप निर्देश प्रदान करें
• ऐप के भीतर एक सहायता/समर्थन लिंक शामिल करें
• सभी व्यवस्थापक स्क्रीन आकारों के लिए उत्तरदायी डिज़ाइन

व्यावसायिक आवश्यकताएँ:

• स्पष्ट और सटीक ऐप स्टोर लिस्टिंग
• पारदर्शी मूल्य निर्धारण और बिलिंग
• गोपनीयता नीति और सेवा की शर्तें
• उचित प्रतिक्रिया समय के साथ समर्थन चैनल

सामान्य अस्वीकृति कारण:

1. अनावश्यक एपीआई अनुमति क्षेत्रों का अनुरोध करना
2. जीडीपीआर वेबहुक हैंडलर गायब
3. ख़राब यूआई जो पोलारिस दिशानिर्देशों का पालन नहीं करता है
4. अपर्याप्त त्रुटि प्रबंधन
5. समीक्षा के दौरान टूटी कार्यक्षमता

समीक्षा प्रक्रिया में आमतौर पर 7-14 कार्यदिवस लगते हैं। फीडबैक को तुरंत संबोधित करें - शॉपिफाई आवश्यक परिवर्तनों पर विशिष्ट मार्गदर्शन प्रदान करता है।

मुद्रीकरण रणनीतियाँ

Shopify बिलिंग एपीआई के माध्यम से कई बिलिंग मॉडल का समर्थन करता है:

मूल्य निर्धारण युक्तियाँ:

• Shopify पहले $1M के राजस्व पर 15% राजस्व हिस्सेदारी लेता है, फिर 0% (उनके वर्तमान भागीदार कार्यक्रम की शर्तों के अनुसार)
• निःशुल्क परीक्षण की पेशकश करें (7-14 दिन मानक है)
• मूल्य निर्धारण स्तरों के बीच स्पष्ट मूल्य अंतर बनाएं
• परिवर्तनीय संसाधन खपत वाले ऐप्स के लिए उपयोग-आधारित मूल्य निर्धारण पर विचार करें

परीक्षण और गुणवत्ता आश्वासन

अपने ऐप को समीक्षा के लिए सबमिट करने से पहले:

1. यूनिट परीक्षण -- मुख्य व्यवसाय तर्क का अलगाव में परीक्षण करें
2. एकीकरण परीक्षण -- शॉपिफाई के डेवलपमेंट स्टोर के साथ एपीआई इंटरैक्शन का परीक्षण करें
3. यूआई परीक्षण -- सत्यापित करें कि पोलारिस घटक सही ढंग से प्रस्तुत होते हैं
4. वेबहुक परीक्षण -- परीक्षण पेलोड के साथ वेबहुक प्रसंस्करण को मान्य करें
5. प्रदर्शन परीक्षण - सुनिश्चित करें कि एपीआई कॉल लोड के तहत दर सीमा के भीतर रहें
6. सुरक्षा ऑडिट -- एक्सएसएस, सीएसआरएफ और इंजेक्शन कमजोरियों की जांच करें
7. OAuth प्रवाह परीक्षण -- इंस्टॉलेशन, प्रमाणीकरण और अनइंस्टॉलेशन सत्यापित करें

विभिन्न स्टोर कॉन्फ़िगरेशन और योजना प्रकारों का अनुकरण करने के लिए शॉपिफाई के पार्टनर डैशबोर्ड का उपयोग करें।

व्यावसायिक ऐप विकास

Shopify ऐप बनाने के लिए React, GraphQL, Node.js और Shopify के विशिष्ट प्लेटफ़ॉर्म पैटर्न में विशेषज्ञता की आवश्यकता होती है। ECOSIRE उन व्यवसायों के लिए पेशेवर Shopify ऐप डेवलपमेंट सेवाएँ प्रदान करता है, जिन्हें मौजूदा ऐप्स से परे कस्टम कार्यक्षमता की आवश्यकता होती है।

चाहे आपको अपने स्टोर के लिए एक कस्टम ऐप की आवश्यकता हो या आप Shopify इकोसिस्टम के लिए एक सार्वजनिक ऐप बनाना चाहते हों, हमारी विकास टीम आर्किटेक्चर, विकास, परीक्षण और ऐप स्टोर सबमिशन को संभालती है। हम ऑटोमेशन समाधान भी प्रदान करते हैं जो शॉपिफाई के एपीआई और वेबहुक के साथ एकीकृत होता है।

हमारी टीम से संपर्क करें अपने Shopify ऐप डेवलपमेंट प्रोजेक्ट पर चर्चा करने के लिए।

मुख्य बातें

• Shopify तीन ऐप प्रकार प्रदान करता है: सार्वजनिक (ऐप स्टोर), कस्टम (एकल स्टोर), और ड्राफ्ट (विकास)
• नए विकास के लिए REST की तुलना में GraphQL एडमिन API की अनुशंसा की जाती है
• वेबहुक मतदान के बिना वास्तविक समय की घटना प्रसंस्करण को सक्षम करता है
• Shopify फ़ंक्शंस WebAssembly के माध्यम से Shopify के बुनियादी ढांचे पर कस्टम बिजनेस लॉजिक चलाते हैं
• ऐप ब्रिज और पोलारिस सुनिश्चित करते हैं कि आपका ऐप Shopify एडमिन के साथ सहजता से एकीकृत हो
• ऐप समीक्षा प्रक्रिया में 7-14 दिन लगते हैं और तकनीकी गुणवत्ता, यूएक्स और व्यावसायिक आवश्यकताओं का मूल्यांकन किया जाता है
• सदस्यता, उपयोग-आधारित बिलिंग, या बिलिंग एपीआई के माध्यम से एकमुश्त शुल्क के माध्यम से मुद्रीकरण करें