Özel nesneler

Kayıt aç

Yeni kayıt açar. Zorunlu alanlar ve seçenekler sunucuda denetlenir (invalid, errors dizisinde tek tek). customer_id verilirse nesnenin firma bağlantısı kurulur; links ile diğer bağlantılar (ilişki anahtarı → hedef kimlik ya da kimlik dizisi). record_created iş akışı ve webhook olayı tetiklenir.

POST/api/v1/objects/{key}/records

Yetkilendirme

Authorizationheaderzorunlu

Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).

Modül: MüşterilerKapsam: crm.write

Yol parametreleri

keystringzorunlu

Nesne anahtarı.

Gövde application/json

namestringzorunlu

Kaydın adı (nesnenin ad alanı, ör. Hat adı).

customer_idintegeristeğe bağlı

Bağlı firma.

fieldsobjectisteğe bağlı

Alan anahtarı → değer.

linksobjectisteğe bağlı

İlişki anahtarı → hedef kimlik(ler).

Hatalar

HTTP	error	Anlamı
`400`	`invalid`	Eksik ya da geçersiz alan (`message` ayrıntıyı verir).
`404`	`not_found`	Kayıt bulunamadı.

İstek

curl -X POST https://ornek.solk.app/api/v1/objects/uretim_hatti/records \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Hat 3 — şişirme",
  "customer_id": 1,
  "fields": {
    "makine_tipi": "Ekstrüzyon",
    "hiz": 180,
    "devreye_alma": "2025-04-01"
  }
}'

const res = await fetch("https://ornek.solk.app/api/v1/objects/uretim_hatti/records", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "Hat 3 — şişirme",
    "customer_id": 1,
    "fields": {
      "makine_tipi": "Ekstrüzyon",
      "hiz": 180,
      "devreye_alma": "2025-04-01"
    }
  }),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/objects/uretim_hatti/records",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "name": "Hat 3 — şişirme",
        "customer_id": 1,
        "fields": {
            "makine_tipi": "Ekstrüzyon",
            "hiz": 180,
            "devreye_alma": "2025-04-01"
        }
    },
)
print(r.json())

Yanıt

{
  "ok": true,
  "record": {
    "active": true,
    "customer": {
      "id": 1,
      "name": "Alize Paketleme San. ve Tic. A.Ş."
    },
    "editable": true,
    "field_list": [
      {
        "display": "Ekstrüzyon",
        "key": "makine_tipi",
        "label": "Makine tipi",
        "options": [
          "Laminasyon"
        ],
        "required": true,
        "type": "select",
        "value": "Ekstrüzyon"
      }
    ],
    "fields": {
      "devreye_alma": "2025-04-01",
      "hiz": 180.0,
      "makine_tipi": "Ekstrüzyon"
    },
    "id": 1,
    "name": "Hat 3 — şişirme",
    "owner": "Deniz Aksoy",
    "owner_id": 1,
    "relations": [
      {
        "items": [
          {
            "id": 1,
            "name": "Alize Paketleme San. ve Tic. A.Ş."
          }
        ],
        "key": "co1_customer",
        "kind": "customer",
        "label": "Firma",
        "many": false,
        "side": "a",
        "target_label": "Firma"
      }
    ],
    "sub": "Ekstrüzyon · 180",
    "updated_at": "2026-10-06T10:26:24",
    "url": "https://ornek.solk.app/o/uretim_hatti/1"
  }
}

Örnek yanıt örnek veriyle çalışan bir v43b kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.