Developer API
HTTPS पर एक आसान JSON REST API। यह हर प्रोग्रामिंग भाषा के साथ काम करता है। Base पता: https://themeharvest.com/api/v1 · Rate limit: हर IP से प्रति मिनट 60 requests (license calls: 30)।
कैटलॉग (key की ज़रूरत नहीं)
GET /items | Live items. Query: q, category (slug), author (username), sort=sales, per_page (1–50), page। |
GET /items/{id} | एक आइटम: price, rating, sales, version, tags, demo और compatibility के साथ। |
GET /categories | सभी categories: id, parent_id, market, name, slug। |
curl "https://themeharvest.com/api/v1/items?sort=sales&per_page=5"
Authors: purchase code verify करें
Studio → API & purchase codes में अपना personal token बनाएँ और उसे Bearer token के रूप में भेजें। सिर्फ़ आपके अपने items की sales मिलती हैं।
GET /author/purchase/verify?code=… | क्या यह purchase code असली है? Item, buyer, license, support date, refunded। |
GET /author/sales | आपकी नई sales (हर पेज पर 50) और आपका बैलेंस। |
GET /author/items | आपके सभी आइटम उनके status के साथ। |
curl -H "Authorization: Bearer YOUR_TOKEN" -H "Accept: application/json" \ "https://themeharvest.com/api/v1/author/purchase/verify?code=PURCHASE-CODE"
License activation (आपके आइटम के अंदर)
आपका आइटम इन्हें buyer के server से call करता है। Token की ज़रूरत नहीं: purchase code + Item ID ही सबूत है। Fields: code, item_id, domain (form या JSON)।
POST /license/activate | Install पर। 200 {"active":true} · 404 not_found · 409 limit_reached · 403 refunded |
GET /license/check | दिन में एक बार — अभी भी valid? |
POST /license/deactivate | Uninstall पर — डोमेन खाली करता है। |
curl -X POST https://themeharvest.com/api/v1/license/activate -d code=PURCHASE-CODE -d item_id=ITEM_ID -d domain=example.com
Authors: PHP, WordPress, Node.js, Python, Java, C#, Go और Flutter का तैयार code (आपकी Item ID के साथ) Studio → My items → 🔑 License & API में है।
अपने आप अपडेट
GET /updates/check?item_id=…&code=…&version=1.0.0 | नया version, changelog और 30 मिनट वाला download link (active purchase चाहिए)। |
GET /updates/{id}/info | किसी आइटम की public version जानकारी। |
Errors
| 401 | Token नहीं है या गलत है |
| 404 | नहीं मिला (गलत code, item या किसी दूसरे item का code) |
| 422 | कोई field नहीं है या सही नहीं है |
| 429 | बहुत ज़्यादा requests — एक मिनट रुकें |
हर जवाब JSON में है। "Accept: application/json" भेजें।