Tek çağrı, tek sözleşme.

Kimlik doğrulama

Kurum anahtarınız hesabı tanımlar; planı, sınırları ve yüklediğiniz özel politikaları taşır. Anahtarı istek gövdesinde gönderin. Sunucu tarafında tutun: tarayıcıda veya mobil uygulama dosyasında duran anahtar, yayımlanmış anahtardır.

Bir taslağı kontrol edin

curl -X POST https://verbapulse.com/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "text": "As agreed, we will match any competitor price for the next three years.",
    "org_api_key": "<your key>",
    "platform": "support-agent"
  }'

İstek alanları

Yanıt

{
  "status": "ok",
  "session_id": "dd1597af-fca5-4c11-9176-ec3a4e0755dc",
  "nda_recipients": [],
  "segments": [
    {
      "text": "we will match any competitor price for the next three years",
      "sentence": "As agreed, we will match any competitor price for the next three years.",
      "start": 11,
      "end": 70,
      "risk_level": "medium",
      "risk_type": "compliance",
      "explanation": "Firm long-term pricing commitment, confirm approval and contractual alignment",
      "suggested_sentence": "we can discuss matching competitor pricing as part of our agreement",
      "fix_type": "sentence"
    }
  ]
}

Tek entegrasyon kuralı

Bu hatayı biz de yaptık. Outlook eklentimiz durum kodunu kontrol etmeden gövdeyi okuyordu; bu yüzden istek sınırına takılan bir yanıt "risk tespit edilmedi" olarak görünüyordu. Bu ürünün yaşayabileceği en tehlikeli arızadır ve gövdeyi önce ayrıştıran her entegrasyonu aynı tuzak bekler.

if r.status_code != 200 or r.json().get("status") != "ok":
    # show "not checked" and let the human decide; never fall through to "clean"
    return Unchecked(reason=r.status_code)

Durum ve hata kodları

Sınırlar ve davranış

Örnekler

import httpx

def check(text: str) -> dict:
    r = httpx.post(
        "https://verbapulse.com/analyze",
        json={"text": text, "org_api_key": KEY, "platform": "support-agent"},
        timeout=30,
    )
    if r.status_code != 200:
        return {"checked": False, "reason": r.status_code}
    d = r.json()
    if d.get("status") != "ok":
        return {"checked": False, "reason": d.get("status")}
    return {"checked": True, "findings": d["segments"]}

async function check(text) {
  const r = await fetch("https://verbapulse.com/analyze", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ text, org_api_key: KEY, platform: "support-agent" }),
  });
  if (!r.ok) return { checked: false, reason: r.status };
  const d = await r.json();
  if (d.status !== "ok") return { checked: false, reason: d.status };
  return { checked: true, findings: d.segments };
}

Veri işleme

• Taslak AB'de işlenir ve mesaj içeriği varsayılan olarak saklanmaz.
• Saklanan olayda kural, sonuç, gönderdiğiniz platform ve departman etiketleri ile zaman bulunur.
• Metniniz model eğitiminde kullanılmaz.
• Kendi ağınızda çalıştırdığınızda aynı API, kendi temel URL'nizde sunulur. Ayrıntılar: Enterprise.

Döndürdüğümüz bulgularla neler yapabileceğiniz, hizmet şartlarının 6. maddesinde düzenlenmiştir. Kısaca: bulguları kendi kurumunuzun yazışmalarını kontrol etmek için kullanın; aynı işi yapan bir modeli eğitmek veya değerlendirmek için kullanmayın.

Sıradaki değişiklik

Üst bilgiyle kimlik doğrulamalı sürümlü sunucu: POST https://api.verbapulse.com/v1/analyze ve Authorization: Bearer, ayrıca bir kullanım uç noktası. Yukarıda anlatılan gövde anahtarı bu değişiklikten sonra da çalışır. Şimdi entegre ediyorsanız temel URL'yi ve kimlik doğrulama yöntemini tek bir sabitin arkasına alın; geçiş iki satırlık bir değişiklik olur.