Sistemlerinizi Marcomm AI'a bağlayın

1. 1
   Erişim için başvurun

   Sisteminizi anlatın ve ihtiyaç duyduğunuz verileri seçin. Başvuruları tek tek inceliyoruz.

2. 2
   Anahtar oluşturun

   Onaydan sonra Ayarlar, API bölümünde bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir, bu yüzden kendi sisteminizde saklayın.

3. 3
   İstek gönderin

   Anahtarı Authorization başlığında gönderin ve aşağıdaki uç noktalardan istediğinizi çağırın.

Örnek istek

curl https://app.marcomm.works/api/v1/news/digest?days=7 \
  -H "Authorization: Bearer mc_live_..."

Anahtarınızı her istekte Bearer belirteci olarak gönderin. Kişisel anahtar, onu oluşturan kişi adına çalışır; bu nedenle o kişinin adına onayları okuyabilir ve karara bağlayabilir. Çalışma alanı anahtarını bir yönetici oluşturur ve yalnızca okuyabilir. Anahtarların süresi dolabilir, IP adresleriyle sınırlandırılabilir ve yenilenebilir: yenilemeden sonra eski anahtar 24 saat daha çalışmaya devam eder.

Her anahtar yalnızca başvurunuzun onaylandığı kapsamları taşır.

news

Haber özeti, makaleler ve medya kuruluşları.

crisis

Kritik haberler ve kriz olayları.

approvals

Bekleyen onaylar ve bunların kişisel anahtarla onaylanması veya reddedilmesi.

content

Basın bültenlerini ve blog yazılarını okuma.

Yollar /api/v1 ile başlar. Okuma uç noktaları GET kullanır ve sorgu parametreleri alır. Yanıt, {"data": ...} biçiminde JSON olarak gelir.

Öğeye {"decision": "approve"} veya {"decision": "reject", "comment": "..."} gönderin. Reddetmek için bir açıklama gerekir. Karar, uygulamadaki ve Slack'teki kurallara tabidir ve anahtar sahibi adına kaydedilir. Metinde onay gerektiren ifadeler varsa uyarılarla birlikte 409 confirmation_required yanıtı alırsınız ve isteği "force": true ile yeniden gönderebilirsiniz.

curl -X POST https://app.marcomm.works/api/v1/approvals/press-releases/<id> \
  -H "Authorization: Bearer mc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"decision":"reject","comment":"Please fix the headline."}'

Sınırlar çalışma alanı başına, dakika ve gün (UTC) bazında belirlenir. Yanıtlar aşağıdaki başlıkları taşır. Bir sınır aşıldığında Retry-After ile 429 alırsınız. Sınırı yükseltmek için Ayarlar, API bölümünden artış talep edin. Ekibimiz talebi inceler.

X-RateLimit-Limit

Dakikada izin verilen istek sayısı.

X-RateLimit-Remaining

Geçerli dakikada kalan istek sayısı.

X-RateLimit-Reset

Dakika penceresinin sıfırlandığı Unix zamanı.

X-RateLimit-Day-Limit

Günde izin verilen istek sayısı.

X-RateLimit-Day-Remaining

Bugün kalan istek sayısı.

Retry-After

Yeniden denemeden önce beklenecek saniye. Yalnızca 429 durumunda.

Hatalar {"error": {"code": ..., "message": ...}} biçiminde JSON olarak döner.

Uyarılar, onay istekleri ve sabah özeti sisteminize de gönderilebilir. Ayarlar, API, Webhook bölümünden bir hedef ekleyin. Her istek; event (alert, approval veya briefing), workspace, title, text, url, data ve sentAt alanlarını içeren bir JSON'dur. Onay isteği, API üzerinden okuyup karara bağlamak için kullanabileceğiniz data.kind (press_release, blog veya event) ve data.id taşır.

İstekler imzalıdır. İsteğin ham gövdesinin HMAC-SHA256 değerini imza anahtarınızla hesaplayın ve sha256=<hex> biçimindeki X-Marcomm-Signature başlığıyla karşılaştırın. Eşleşmeyen istekleri reddedin.

Node.js'te Webhook doğrulama

import { createHmac, timingSafeEqual } from 'node:crypto';

export function isFromMarcomm(rawBody: string, signature: string, secret: string) {
  const expected = 'sha256=' + createHmac('sha256', secret).update(rawBody).digest('hex');
  const a = Buffer.from(expected);
  const b = Buffer.from(signature);
  return a.length === b.length && timingSafeEqual(a, b);
}