B2BB2B LLM

Geri aramalar

İmzalı, bağımsız sunucular arası olayları ve tamamlanmış eşzamansız sonuçları alın.

Geri aramalar

Bir geri arama URL'sini yapılandırın Profil → Geri aramalar ve eşzamansız sonuçlar. Model Kapısı HTTPS gönderir POST Etkinleştirilmiş hesap bildirimlerine yönelik istekler ve tamamlanmış yerel eşzamansız çıkarım istekleri. Geri arama teslimi, çıkarım işleminden bağımsızdır ve özel, dayanıklı bir Model Gate çalışan kuyruğu üzerinden gerçekleştirilir.

Geri arama URL'si ve giden güvenlik

Herkese açık olarak erişilebilen bir HTTPS uç noktası kullanın. Geri arama URL'si doğrulaması, giden bir güvenlik sınırıdır. Geri döngü, özel, yerel bağlantı, taşıyıcı düzeyinde NAT, dokümantasyon/test, çok noktaya yayın, belirtilmemiş ve ayrılmış IP aralıkları reddedilir. Ana bilgisayar adı kaydedildiğinde ve teslimat sırasında tekrar doğrulanır; yönlendirmeler yeniden doğrulanır. Geri aramaları dahili hizmetlere yönlendirmeyin veya özel ağlara yönlendirmeyin.

Ortak etkinlik zarfı

Her geri arama aynı zarfı kullanır:

{
  "event_id": "01J...",
  "event": "account.balance_low",
  "occurred_at": "2026-08-28T07:00:00Z",
  "data": {}
}

event_id bir mantıksal olayın her yeniden denemesinde kararlıdır. Teslimatları tekilleştirme şu tarihe kadar: event_id; yükün geri kalanını karşılaştırarak kimlik çıkarımı yapmayın. occurred_at UTC RFC3339'dur. Yükler zamanla ek alanlar kazanabilir, bu nedenle tüketicilerin bilinmeyen alanları göz ardı etmesi gerekir.

Her teslimat aynı olay kimliğini de içerir X-Model-Gate-Event-ID.

Etkinlik kataloğu

account.balance_low

{
  "event_id": "01J...",
  "event": "account.balance_low",
  "occurred_at": "2026-08-28T07:00:00Z",
  "data": {
    "balance": "10.1234567890",
    "threshold": "20.0000000000",
    "currency": "USD"
  }
}

key.spend_limit_threshold_reached

{
  "event_id": "01J...",
  "event": "key.spend_limit_threshold_reached",
  "occurred_at": "2026-08-28T07:00:00Z",
  "data": {
    "key_id": "KEY_PUBLIC_ID",
    "key_name": "Bank integration",
    "usage": "80.1234567890",
    "spend_limit": "100.0000000000",
    "threshold_percent": 80,
    "currency": "USD"
  }
}

group.spend_limit_threshold_reached

Yük kullanımları group_id, group_name, tam ondalık sayı usage, tam ondalık sayı spend_limit, tamsayı threshold_percent, Ve currency = "USD".

request.completed

{
  "event_id": "01J...",
  "event": "request.completed",
  "occurred_at": "2026-08-28T07:00:00.123456Z",
  "data": {
    "request_id": "01J...",
    "status": "completed",
    "response_status": 200,
    "response": {"id":"msg_...","type":"message"}
  }
}

response_status yukarı akış HTTP durumu mevcut olmadığında null yapılabilir. Başarısız/iptal edilmiş/süresi dolmuş eşzamansız sonuçlar şunları içerebilir: data.error.

Geri arama yüklerindeki mali değerler tam ondalık dizelerdir; bunlar kullanıcı arayüzünde yuvarlatılmış görüntü değerleri değildir.

İzlenen değer eşik koşulundan çıktıktan sonra eşik uyarıları yeniden etkinleştirilir. Eşik çalışanı, çıkarım sıcak yolunun dışında, koşulları yaklaşık dakikada bir kez değerlendirir, dolayısıyla eşik geri aramaları gerçek zamanlı bir milisaniyelik geçiş sinyali değildir.

Talep formatı

POST /model-gate/callback HTTP/1.1
Content-Type: application/json
X-Model-Gate-Event-ID: 01J...
X-Model-Gate-Signature: t=1710000000,v1=hex_hmac_sha256

İmza doğrulama

HMAC-SHA256'yı tam dize üzerinden hesaplayın <timestamp>.<raw_body> Profilde oluşturulan geri arama sırrını kullanarak. Tam sır yalnızca oluşturulduğunda veya döndürüldüğünde gösterilir ve beklemedeyken şifrelenmiş olarak saklanır. Onaltılı imzayı sabit zamanda karşılaştırın ve kabul edilen yeniden oynatma pencerenizin dışındaki zaman damgalarını reddedin. HMAC zaman damgası bir teslimat girişimine özeldir; the event_id yeniden denemelerde sabit kalır.

Teslimat, yanıt ve yeniden denemeler

Herhangi bir HTTP 2xx yanıt olayı kabul eder. HTTP 200 boş gövde ile kullanılması tavsiye edilir. Aktarım hataları, zaman aşımları ve 2xx olmayan her yanıt başarısızlıktır.

Her olayın en fazla toplam 6 deneme: ilk deneme artı beş yeniden deneme. 1-5 arası başarısız girişimler takip eder 5 saniye, 30 saniye, 2 dakika, 10 dakika ve 1 saat. Her denemenin zorlu bir süreci vardır 15 saniye genel zaman aşımı. Altıncı başarısız denemeden sonra olay ölümcül hale gelir failed ve başka otomatik yeniden deneme yoktur. Eski işçi talepleri otomatik olarak kalıcı kuyruğa döndürülür.

Yanıt vermeden uzun süreli işler yapmayın. İmzayı doğrulayın, devam ettirin/tekilleştirin: event_id, geri dönmek 2xxve eşzamansız olarak işleyin.

İlgili belgeler