İçeriğe geç

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_…"
YanıtÖrnek veri
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ı.

GET/api/v1/orders

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…
imza-dogrula.mjs
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.

  1. 01

    Anahtar oluşturun

    Panelde Ayarlar → API anahtarları. Kapsamı ve şubeyi seçin; hx_live_ ile başlayan anahtar bir kez gösterilir.

  2. 02

    Şemayı alın

    OpenAPI 3 şeması tek dosyada. Postman, Insomnia ya da kod üreticinize doğrudan verin.

  3. 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.

Çerez tercihleriniz

Sitenin çalışması için zorunlu çerezler kullanıyoruz. Ziyaretleri ölçmek için analitik çerezleri ise yalnız onay verirseniz kullanırız. Çerez politikası · Aydınlatma metni