உங்கள் ஆர்டர்கள், உங்கள் சொந்தக் கருவிகளில்.
Grow உடன் ஆர்டர்கள், பொருட்கள், இருப்பை உங்கள் சொந்த அறிக்கைகளுக்குள் இழுக்கப் படிக்க-மட்டும் API விசைகளை உருவாக்கலாம்; ஆர்டர் செலுத்தப்படும்போதோ, அனுப்பப்படும்போதோ, டெலிவர் ஆகும்போதோ, ரத்தாகும்போதோ, பணம் திருப்பப்படும்போதோ கையொப்பமிட்ட ஆர்டர் நிகழ்வுகளை உங்கள் சர்வருக்கு அனுப்பலாம்.
Grow பெறுக- 5
- செயலில் உள்ள படிக்க-மட்டும் API விசைகள்
- 60 / நிமிடம்
- ஒவ்வொரு விசைக்கும் அனுமதிக்கப்படும் கோரிக்கைகள்
- 5 நிகழ்வுகள்
- செலுத்தப்பட்டது, அனுப்பப்பட்டது, டெலிவர் ஆனது, ரத்தானது, பணம் திருப்பப்பட்டது
- 30 நாட்கள்
- வெற்றிகரமான டெலிவரிகள் பதிவில் வைக்கப்படும் காலம்
01 — API விசைகள்
விசையுடன் உங்கள் தரவைப் படியுங்கள்.
அமைப்புகள் → ஒருங்கிணைப்புகளில் ஐந்து படிக்க-மட்டும் விசைகள் வரை உருவாக்குங்கள். ஒவ்வொன்றுக்கும் அணுகலைக் குறியிடுங்கள்: ஆர்டர்கள், பொருட்கள் அல்லது இருப்பு. விசை ஒருமுறை மட்டுமே காட்டப்படும், எனவே அப்போதே நகலெடுங்கள்; தொலைத்தால், அதை ரத்து செய்து புதியதை உருவாக்குங்கள். விசையை Bearer டோக்கனாகக் கொண்டு GET /api/v1/orders, /api/v1/products அல்லது /api/v1/inventory ஐ அழையுங்கள். பதில்கள் JSON, இயல்பாக ஒரு பக்கத்துக்கு 50 உருப்படிகள் (100 வரை), அடுத்த பக்கத்துக்கான கர்சருடன்; ஒவ்வொரு விசையும் நிமிடத்துக்கு 60 கோரிக்கைகள் செய்யலாம். விசையை ரத்து செய்தாலோ Grow முடிந்தாலோ அணுகல் நிற்கும்.
- 5 செயலில் உள்ள விசைகள் வரை, ஒவ்வொன்றுக்கும் தனி அணுகல்
- GET மட்டும்: ஆர்டர்கள், பொருட்கள், இருப்பு
- பக்கத்துக்கு 50, 100 வரை; நிமிடத்துக்கு 60 கோரிக்கைகள்
GET /api/v1/orders?limit=50Authorization: Bearer jjk_…{ "data": [ … ], "nextCursor": "…" }இந்த விசையை இப்போதே நகலெடுங்கள். இது மீண்டும் காட்டப்படாது.
விளக்கத்திற்கான மாதிரித் தரவு
02 — வெப்ஹுக்குகள்
ஆர்டர்கள் மாறும்போது தெரிந்துகொள்ளுங்கள்.
அமைப்புகள் → ஒருங்கிணைப்புகள் → ஆர்டர் வெப்ஹுக்குகளில் ஒரு HTTPS முனையைச் சேர்த்து நிகழ்வுகளைத் தேர்ந்தெடுங்கள்: order.paid, order.shipped, order.delivered, order.cancelled, order.refunded. ஒவ்வொரு டெலிவரியும் நிகழ்வு, தனித்த நிகழ்வு விசை, நிகழ்ந்த நேரம், ஆர்டரின் ஸ்னாப்ஷாட் கொண்ட JSON சுமை: பொருட்கள், சென்னில் மொத்தங்கள், நிலைகள், வாங்குபவர் மற்றும் ஷிப்பிங் விவரங்கள். முதலில் ஒரு சோதனையை அனுப்புங்கள். டெலிவரிகள் வரிசையில் வைக்கப்பட்டு சில நிமிடங்களுக்கு ஒருமுறை அனுப்பப்படும்; எனவே ஆர்டர் மாறிய சில நிமிடங்களுக்குள் அவை வந்து சேரும் என எதிர்பாருங்கள்.
- ஐந்து ஆர்டர் நிகழ்வுகள்
- HTTPS முனைகள் மட்டும்
- சார்ந்திருக்கும் முன் ஒரு சோதனை நிகழ்வை அனுப்புங்கள்
{ "event": "order.paid", "event_key": "…", "occurred_at": "…", "order": { … } }டெலிவரிகள் வரிசையில் வைக்கப்பட்டு சில நிமிடங்களுக்கு ஒருமுறை அனுப்பப்படும்.
விளக்கத்திற்கான மாதிரித் தரவு
03 — சரிபார்
ஒவ்வொரு கோரிக்கையும் எங்களிடமிருந்தே வருகிறது என உறுதிசெய்யுங்கள்.
ஒவ்வொரு கோரிக்கையிலும் X-JomJual-Signature தலைப்பு இருக்கும்: ஒரு நேர முத்திரையும், அந்த நேர முத்திரை, ஒரு புள்ளி, மூலக் கோரிக்கை உடல் ஆகியவற்றின் HMAC-SHA256 கையொப்பமும், உங்கள் முனையின் கையொப்ப ரகசியத்தைக் கொண்டு உருவாக்கப்பட்டவை (முனையை உருவாக்கும்போது ஒருமுறை மட்டும் காட்டப்படும்). உங்கள் பக்கம் மீண்டும் கணக்கிட்டு, மாறாத நேரத்தில் ஒப்பிட்டு, ஐந்து நிமிடங்களுக்கு மேற்பட்ட நேர முத்திரைகளை நிராகரியுங்கள். X-JomJual-Event-Id ஒவ்வொரு நிகழ்வுக்கும் தனித்த விசை. டெலிவரி குறைந்தது ஒருமுறை நடக்கும்; எனவே மீண்டும் வருவனவற்றைத் தவிர்க்க அதைப் பயன்படுத்துங்கள். பத்து விநாடிகளுக்குள் ஏதேனும் 2xx பதிலை அனுப்புங்கள்.
- உங்கள் கையொப்ப ரகசியத்துடன் HMAC-SHA256
- ஐந்து நிமிடங்களுக்கு மேற்பட்ட நேர முத்திரைகளை நிராகரியுங்கள்
- X-JomJual-Event-Id மூலம் நகல்களைத் தவிருங்கள்
X-JomJual-Signature: t=1760000000,v1=9f2c…- HMAC-ஐ மீண்டும் கணக்கிடுங்கள்நேர முத்திரை, ஒரு புள்ளி, பின்னர் மூல உடல், உங்கள் ரகசியத்துடன்1
- மாறாத நேரத்தில் ஒப்பிடுங்கள்பொருந்தவில்லை என்றால் கோரிக்கையை நிராகரியுங்கள்2
- நேர முத்திரையைச் சரிபாருங்கள்ஐந்து நிமிடங்களுக்கு மேற்பட்டதை நிராகரியுங்கள்3
- மீண்டும் வருவனவற்றைத் தவிருங்கள்X-JomJual-Event-Id மூலம் நகல்களைத் தவிருங்கள்4
விளக்கத்திற்கான மாதிரித் தரவு
04 — மீண்டும் முயற்சி
மீண்டும் முயற்சி, மறுஅனுப்பல் மற்றும் பதிவு.
பத்து விநாடிகளுக்குள் உங்கள் முனை 2xx பதிலளிக்காவிட்டால், JomJual 1 நிமிடம், 5 நிமிடம், 30 நிமிடம், 2 மணி, 6 மணி நேரத்துக்குப் பின் மீண்டும் முயலும், அதன் பின் தினமும். அது உங்கள் முனையை அணைக்காது. டெலிவரிப் பதிவு ஒவ்வொரு டெலிவரியின் நிலை, முயற்சிகள், பதிலைக் காட்டும்; மறுஅனுப்பு என்பது ஒன்றை மீண்டும் அனுப்பும். வெற்றிகரமான டெலிவரிகள் 30 நாட்கள் வரை, ஒரு முனைக்கு 1,000 வரை வைக்கப்படும்.
- 1 நிமிடம், 5 நிமிடம், 30 நிமிடம், 2 மணி, 6 மணிக்குப் பின் மீண்டும் முயற்சி, பிறகு தினமும்
- பதிவிலிருந்து எந்த டெலிவரியையும் மறுஅனுப்பலாம்
- தோல்வியடைவதற்காக முனைகள் ஒருபோதும் அணைக்கப்படாது
- order.paid1 முயற்சி · 200டெலிவர் ஆனது
- order.shipped2 முயற்சிகள் · 503நிலுவையில்
- order.delivered1 முயற்சி · 200டெலிவர் ஆனது
மறுஅனுப்பு என்பது எந்த டெலிவரியையும் மீண்டும் அனுப்பும்.
விளக்கத்திற்கான மாதிரித் தரவு
விற்பனையாளர்கள் ஏன் மாறுகிறார்கள்
முன்பு
ஆர்டர்களை நகலெடுத்து ஒட்டுவது
- ஆர்டர்களைக் கையால் ஏற்றுமதி செய்வது
- புதிய ஆர்டர்களுக்காக டாஷ்போர்டைப் பார்ப்பது
- ஆர்டர் விவரங்களை மற்ற கருவிகளில் மீண்டும் தட்டச்சு செய்வது
JomJual உடன்
உங்கள் கருவிகளைச் சென்றடையும் ஆர்டர்கள்
- உங்கள் அறிக்கைகளுக்கான படிக்க-மட்டும் API
- ஆர்டர் மாறும்போது கையொப்பமிட்ட வெப்ஹுக்குகள்
- மீண்டும் முயற்சிகளும் டெலிவரிப் பதிவும்
விற்பனையாளர்கள் கேட்கும் கேள்விகள்.
இது Grow-வில் உள்ளடங்குமா?
ஆம். API விசைகளும் ஆர்டர் வெப்ஹுக்குகளும் Grow-வின் பகுதி. Grow முடிந்தால், API அணுகல் நிற்கும்.
API எதையாவது மாற்ற முடியுமா?
இல்லை. விசைகள் படிக்க-மட்டும், API GET கோரிக்கைகளுக்கு மட்டுமே பதிலளிக்கும்.
வெப்ஹுக்குகள் எவ்வளவு விரைவாக வந்து சேரும்?
டெலிவரிகள் வரிசையில் வைக்கப்பட்டு சில நிமிடங்களுக்கு ஒருமுறை அனுப்பப்படும்; எனவே ஆர்டர் மாறிய சில நிமிடங்களுக்குள் அவை வந்து சேரும் என எதிர்பாருங்கள்.
என் சர்வர் செயலிழந்திருந்தால்?
JomJual 1 நிமிடம், 5 நிமிடம், 30 நிமிடம், 2 மணி, 6 மணிக்குப் பின் மீண்டும் முயலும், அதன் பின் தினமும்; உங்கள் முனையை அணைக்காது. பதிவிலிருந்து எந்த டெலிவரியையும் மறுஅனுப்பவும் செய்யலாம்.
ஒரே நிகழ்வு இருமுறை வருமா?
ஆம், டெலிவரி குறைந்தது ஒருமுறை நடக்கும். ஒவ்வொரு நிகழ்வுக்கும் X-JomJual-Event-Id மற்றும் event_key-இல் தனித்த விசை உண்டு; ஏற்கனவே கையாண்ட விசைகளைத் தவிருங்கள்.
இதை யார் அமைக்கலாம்?
கடை உரிமையாளர்கள், அமைப்புகள் → ஒருங்கிணைப்புகளில்.