REST · Webhook · MCP · OpenAPI 3
Siparişiniz, stoğunuz, faturanız: bir istek uzağınızda.
Kendi sitenizi, depo yazılımınızı ya da muhasebe programınızı HEXIMES'e bağlayın. Veriyi REST ile çekin, değişiklik olunca imzalı olay adresinize gelsin.
https://heximes.com.tr/api/v1
curl https://heximes.com.tr/api/v1/orders \
-H "Authorization: Bearer hx_live_…"HTTP/1.1 200 OK
x-ratelimit-limit: 120
x-ratelimit-remaining: 119
{
"data": [
{ "id": "SIP-10482", "channel": "trendyol",
"branch": "merkez", "items": 2, "total": 270 }
],
"meta": { "tenant": "…" }
}Uç noktalar
Bir uç noktaya tıklayın, ne gidip ne döndüğünü görün.
Hepsi JSON. Hata olursa her yanıtta aynı biçim: kod, açıklama ve destekle paylaşabileceğiniz istek numarası.
Pazaryeri, kasa ve sizin uygulamanızdan gelen siparişler tek listede. Her siparişte kanal, şube ve durum bilgisi gelir.
Yanıt Örnek veri
{
"data": [
{ "id": "SIP-10482", "channel": "trendyol",
"branch": "merkez", "status": "hazirlaniyor",
"items": 2, "total": 270 }
],
"meta": { "tenant": "…" }
}Webhook
Sormanıza gerek yok. Olunca haber gelir.
Abone olduğunuz olay gerçekleşince adresinize POST gelir. Her gönderim zaman damgası ve HMAC-SHA256 imzası taşır; imzayı doğrulamadan işlemeyin.
- order.createdYeni sipariş düştü
- stock.movedStok hareketi oldu
- invoice.voidedFatura iptal edildi
- invoice.creditedİade faturası kesildi
- x-heximes-event
- order.created
- x-heximes-timestamp
- 1763740800
- x-heximes-signature
- v1=9f2c…
import crypto from "node:crypto";
// Gelen istek: x-heximes-timestamp, x-heximes-signature, x-heximes-event
export function dogrula(ts, imza, hamGovde, sir) {
const mac = crypto.createHmac("sha256", sir)
.update(`${ts}.${hamGovde}`).digest("hex");
const beklenen = Buffer.from(`v1=${mac}`);
const gelen = Buffer.from(imza);
return beklenen.length === gelen.length
&& crypto.timingSafeEqual(beklenen, gelen);
}Sınırlar ve güvenlik
Kurallar baştan belli.
120
istek / dk
Anahtar başına. Kalan hak her yanıtta x-ratelimit-remaining başlığında.
5
deneme
Ulaşılamayan webhook artan aralıklarla yeniden denenir; iki deneme arası en çok 60 dk.
1
anahtar = 1 firma
Kiracı başlıktan değil anahtardan okunur. Başka firmanın verisi görünmez.
Kapsam
anahtarda yazılı
Hangi veri ve hangi şube açık, anahtar oluşturulurken seçilir. Kapsam yetmezse 403 döner.
MCP
Yapay zekâ ajanınız da aynı anahtarla bağlansın.
Model Context Protocol uç noktası POST /api/mcp. API anahtarıyla ya da OAuth 2.1 ile bağlanın; Claude ya da kendi ajanınız stoğu, siparişi, faturayı, finansı ve pazaryerini okur. 39 araçtan 30'u salt okunurdur: ERP verisinin yanında Heximes One, Export, B2B, Ads (ROAS ve POAS) ve WhatsApp (ayrı kapsam, numaralar maskeli) özetleri.
9 yazma aracı varsayılan olarak onay kuyruğuna düşer: yetkili kişi Heximes'te onaylayınca uygulanır, firma ayarından onaysız uygulamaya açılabilir. Her çağrı denetim kaydına yazılır, bağlı uygulamalar ERP'den tek tıkla kaldırılır. Hazır kaynaklar (günlük özet, kritik stok) ve istemler de gelir.
Bağladığınız yapay zekâ uygulaması (ör. Claude, ChatGPT) verdiğiniz yetki kapsamındaki verileri okur ve kendi sağlayıcısında işler. Yalnız güvendiğiniz uygulamaları bağlayın; erişimi buradan her an kaldırabilirsiniz.
- stok_bakiye
- siparis_listele
- fatura_listele
- pazaryeri_stok
- one_ozet
- export_dosya
- b2b_havuz
- ads_kampanya
- wa_rapor
- cekirdek_islem
- ve 29 araç daha
Başlangıç
İlk isteğe üç adım.
- 01
Anahtar oluşturun
Panelde Ayarlar → API anahtarları. Kapsamı ve şubeyi seçin; hx_live_ ile başlayan anahtar bir kez gösterilir.
- 02
Şemayı alın
OpenAPI 3 şeması tek dosyada. Postman, Insomnia ya da kod üreticinize doğrudan verin.
- 03
Olayları dinleyin
Webhook adresinizi ekleyin; sipariş ve stok değişince sorgulamanıza gerek kalmaz.
Bağlantıyı bugün kurun
Hesap açın, panelden anahtarınızı oluşturun, ilk siparişi dakikalar içinde çekin.
