प्रति-की प्रमाणीकरण से सुरक्षित एक वर्शन्ड JSON REST API। जॉब्स, इनवॉइस, पेमेंट, एस्टिमेट और ग्राहकों से जुड़े 12 इवेंट्स के लिए webhooks सब्सक्राइब करें। Scale टियर पर उपलब्ध।
curl https://api.servicesynchq.com/api/v1/jobs \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"customerId": 12345,
"scheduledDate": "2026-08-20T14:00:00Z",
"title": "HVAC repair"
}'{ "id": 84213, "customerId": 12345, "status": "scheduled", "scheduledDate": "2026-08-20T14:00:00Z", "title": "HVAC repair", "createdAt": "2026-07-24T08:14:22Z"}आपके डेटा की एक झलक। ग्राहक, जॉब्स, इनवॉइस, एस्टिमेट, भुगतान, इन्वेंट्री, शेड्यूलिंग और नोटिफिकेशन — सभी JSON पर पूर्ण CRUD उपलब्ध कराते हैं।
JSON पर पूरा CRUD — सुरक्षित रखती है आपकी X-API-Key।
एक एंडपॉइंट रजिस्टर करें और रियल-टाइम में एक्शन लें।
इंटीग्रेट करने के दो तरीके — रीड/राइट के लिए REST, रियल-टाइम पुश के लिए webhooks।
/api/v1/customers
सभी ग्राहकों की सूची।
कर्सर-पेजिनेटेड/api/v1/customers
एक नया कस्टमर बनाएं।
idempotency-key समर्थित/api/v1/jobs
स्टेटस या तारीख के आधार पर फ़िल्टर किए गए जॉब्स की सूची।
सॉर्ट व फ़िल्टर योग्य/api/v1/jobs
नया जॉब शेड्यूल करें। यह ट्रिगर करता है job.created webhook।
/api/v1/invoices
पेजिनेशन के साथ इनवॉइस की सूची।
अधिकार-क्षेत्र-सजग/api/v1/invoices/:id/send
ईमेल या SMS के ज़रिए इनवॉइस भेजें। IN के लिए IRN अपने-आप जनरेट होता है।
retry-queue समर्थितग्राहक · जॉब्स · एस्टिमेट · इनवॉइस · पेमेंट · इन्वेंट्री · खरीद · शेड्यूलिंग · नोटिफिकेशन का एक प्रतिनिधि नमूना। हर विशेषाधिकृत कॉल audit-logged होती है। पूरा रेफ़रेंस देखें →
बस एक कंट्री कोड पास करें और पाएं सही टैक्स गणना, सही डॉक्यूमेंट लेआउट, सही e-invoice payload। वही endpoints, अधिकार-क्षेत्र के अनुसार व्यवहार — आपके इंटीग्रेशन कोड में हर देश के लिए अलग कोड की ज़रूरत नहीं।
बस अपना इरादा बताइए — सही टैक्स ब्रेकडाउन की गणना हम कर देते हैं। राज्य बदले, रजिस्ट्रेशन बदले या अधिकार-क्षेत्र टॉगल हो — ये सब डेटा हैं, कोड नहीं। बैंकिंग-स्तर का आइसोलेशन: हर कस्टमर का डेटा अपने अलग लॉजिकल वॉल्ट में रहता है — डेटाबेस खुद वॉल्ट्स के बीच डेटा मिलाने से इनकार करता है, सिर्फ़ ऐप कोड ही नहीं।
आपूर्तिकर्ता का राज्य ग्राहक के समान? CGST + SGST। अलग? IGST। गणना इससे होती है — company.state बनाम customer.state।
POST पर IRN + हस्ताक्षरित QR जनरेट करता है। 24h cancellation window समर्पित एंडपॉइंट के ज़रिए उपलब्ध। HSN कोड लुकअप के ज़रिए।
अपने-आप कटौती करता है 20% / 30% / 0% प्रत्येक सबकॉन्ट्रैक्टर के लिए, कॉन्ट्रैक्टर की पंजीकरण स्थिति के आधार पर।
Phase 1 द्विभाषी इनवॉइस + TLV QR, जो एन्कोड करता है सभी 5 mandatory tags। रेंडर से पहले ZATCA के विरुद्ध सत्यापित करता है।
हर अनुरोध को एक API key से प्रमाणित किया जाता है, जो इस header में भेजी जाती है
X-API-Key हेडर में। कीज़ आपके टेनेंट एडमिन द्वारा बनाई जाती हैं,
किसी भी समय रद्द की जा सकती हैं, और हर विशेषाधिकृत कॉल audit-logged होती है।
कीज़ केवल बनाते समय एक बार दिखाई जाती हैं और सिर्फ़ hash के रूप में संग्रहित होती हैं — कभी plaintext में नहीं।
X-API-Key हेडर में, हर रिक्वेस्ट पर भेजें।
curl https://api.servicesynchq.com/api/v1/customers \
-H "X-API-Key: YOUR_API_KEY"
# 200 OK — returns your customers as JSON.
# Manage keys under Settings → API keys (admin only).CRM, डिस्पैच, बिलिंग, पेमेंट, खरीद और ऑडिट के लाइफसाइकल इवेंट्स सब्सक्राइब करें। हर webhook क्रिप्टोग्राफ़िक रूप से साइन किया जाता है, exponential backoff के साथ रीट्राई होता है, और एक टिकाऊ retry-queue से समर्थित है।
job.created
नया जॉब बनाया गया।
job.completed
जॉब को पूरा के रूप में मार्क किया गया।
job.status_changed
एक जॉब नई स्थिति में पहुंचा।
invoice.created
नया इनवॉइस बनाया गया।
invoice.paid
इनवॉइस का भुगतान प्राप्त हुआ।
invoice.overdue
इनवॉइस बिना भुगतान अपनी देय तिथि पार कर गया।
payment.received
एक ग्राहक भुगतान दर्ज किया गया।
customer.created
नया कस्टमर जोड़ा गया।
estimate.sent
एस्टिमेट ग्राहक को भेजा गया।
estimate.accepted
ग्राहक ने एस्टिमेट स्वीकार किया।
estimate.rejected
कस्टमर ने एस्टिमेट अस्वीकार किया।
estimate.converted_to_job
स्वीकृत एस्टिमेट को जॉब में बदल दिया गया।
आधिकारिक SDKs विकसित हो रहे हैं। जब तक वे उपलब्ध नहीं होते, REST API ऊपर पूरी तरह प्रलेखित है और किसी भी HTTP क्लाइंट के साथ काम करता है।
हर रिक्वेस्ट स्वतः आपके वर्कस्पेस तक सीमित रहती है, वह भी डेटाबेस लेयर — सिर्फ़ एप्लिकेशन कोड में नहीं। एक वर्कस्पेस की क्वेरी वस्तुतः दूसरे वर्कस्पेस का डेटा पढ़ ही नहीं सकती — डेटाबेस स्वयं इसे लागू करता है।
बर्स्ट क्षमता के साथ उचित-उपयोग रेट लिमिट। आपकी वर्तमान सीमा और बची हुई कोटा
हर रिस्पॉन्स में लौटती है — X-RateLimit-Limit / X-RateLimit-Remaining /
X-RateLimit-Reset हेडर्स में (IETF ड्राफ्ट स्टैंडर्ड)। आपको कभी अनुमान नहीं लगाना पड़ेगा कि क्या अनुमत है।
सामान्य इंटीग्रेशन के लिए पर्याप्त हेडरूम · हेडर्स आपको बताते हैं रियल-टाइम में
हाई-थ्रूपुट सिंक, बल्क एक्सपोर्ट और ETL वर्कलोड के लिए
सेल्स से संपर्क करें साइज़िंग के लिए
429 Too Many Requests के साथ एक Retry-After हेडर कुछ ही सेकंड में मिलेगा।
हमारे SDKs इसे exponential backoff के साथ अपने-आप संभाल लेते हैं।
अगर आपको नियमित रूप से और ऊंची सीमाएं चाहिए, हमसे बात करें
— प्रकाशित संख्याएं न्यूनतम हैं, अधिकतम नहीं।
हम आपकी कीज़ को उसी तरह सुरक्षित रखते हैं जैसे हम अपनी कीज़ को रखना चाहेंगे। यहां वह है जिस पर आप भरोसा कर सकते हैं।
रेफरेंस डॉक्स, changelog, और अटकने पर दूसरी ओर एक असली इंसान।
API एक्सेस Scale टियर में शामिल है। पहले दस्तावेज़ पढ़ें, तैयार होने पर अपनी keys प्राप्त करें।