Çalışma alanı

Kartvizitten kişi kaydet

multipart/form-data (ya da JSON): data (JSON) — customer_id (kayıtlı firma) ya da new_customer {name, website, phone, address, city} ya da contact_id (var olan kişiyi tamamla — dolu alanlara dokunulmaz) + contact {name, title, department, phone, phone2, email} + confirm_new; image — kartvizit fotoğrafı (firmaya Kartvizit · Ad adlı ek). Yeni firmada aynı ad → 409 exists (customer), benzer ad → 409 similar (similar; yine de açmak için confirm_new: true). Diğer telefon kişinin notuna yazılır.

POST/api/v1/cards/save

Yetkilendirme

Authorizationheaderzorunlu

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

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

Gövde application/json

datastringzorunlu

JSON (yukarıdaki alanlar).

imagefileisteğe bağlı

Kartvizit fotoğrafı (jpg, png, heic; en çok 15 MB).

Hatalar

HTTP	error	Anlamı
`400`	`invalid`	Eksik ya da geçersiz alan (`message` ayrıntıyı verir).
`403`	`plan`	plan
`404`	`not_found`	Kayıt bulunamadı.
`409`	`exists`	Bu adla firma var (`customer` alanında döner).
`409`	`similar`	Benzer adlı firmalar var (`similar`); `confirm_new: true` ile yine açılır.

İstek

curl -X POST https://ornek.solk.app/api/v1/cards/save \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/cards/save", {
  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/cards/save",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())

Yanıt