Notlar
Not yaz / güncelle
id yoksa yeni not açar (kayda bağlı olmalı), varsa günceller. mentions içindeki kullanıcılar metinde @Ad Soyad olarak geçiyorsa bildirim alır (notified). Boş not kaydedilmez (empty).
Yetkilendirme
AuthorizationheaderzorunluBearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).
Kapsam:
crm.writeGövde application/json
idintegeristeğe bağlıGüncellenecek not.
kindstringisteğe bağlıKayıt türü (yeni notta gerekli).
Değerler
customeroppticketcontractobj_idintegeristeğe bağlıKayıt kimliği (yeni notta gerekli).
titlestringisteğe bağlıBaşlık.
bodystringisteğe bağlıMarkdown metin (en çok 20 000 karakter).
mentionsarrayisteğe bağlıBahsedilen kullanıcı kimlikleri (
/me → team).Hatalar
| HTTP | error | Anlamı |
|---|---|---|
400 | invalid | Eksik ya da geçersiz alan (`message` ayrıntıyı verir). |
403 | forbidden | Kaydı görme / düzenleme yetkiniz yok. |
404 | not_found | Kayıt bulunamadı. |
İstek
curl -X POST https://ornek.solk.app/api/v1/notes \
-H "Authorization: Bearer $SOLK_API_KEY"const res = await fetch("https://ornek.solk.app/api/v1/notes", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
},
});
const data = await res.json();import os, requests
r = requests.post(
"https://ornek.solk.app/api/v1/notes",
headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())Yanıt