Çalışma alanı

Kartvizitimi güncelle

Yalnız gönderilen alanlar değişir; yanıt GET /card ile aynıdır. enabled: true kartı yayınlar, false yayından kaldırır. Ad, e-posta, telefon ve fotoğraf profilden gelir (POST /profile). website https:// olmadan da kabul edilir (ornek.com → https://ornek.com); yalnız http / https. Gizli bir alanı boş göndermek kayıtlı değeri silmez. Kart yayındaysa Apple Wallet'taki kopyası kendiliğinden güncellenir. Yönetici kartvizitleri kapattıysa 403 disabled (gövdede güncel card). JSON ya da form gövdesi.

POST/api/v1/card

Yetkilendirme

Authorizationheaderzorunlu

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

Kapsam: crm.write

Gövde application/json

enabledbooleanisteğe bağlı

Yayında mı.

titlestringisteğe bağlı

Unvan (en çok 120 karakter).

departmentstringisteğe bağlı

Birim (en çok 80 karakter).

mobilestringisteğe bağlı

Cep telefonu (en çok 40 karakter; rakam, boşluk, + ( ) . - /).

websitestringisteğe bağlı

Web sitesi (en çok 200 karakter). Boşsa açık sayfada firmanın web adresi görünür.

addressstringisteğe bağlı

Adres (en çok 250 karakter; varsayılan gizli).

aboutstringisteğe bağlı

Hakkında (en çok 280 karakter).

showobjectisteğe bağlı

Görünür alanlar — gönderilen anahtarlar değişir: photo, title, department, email, phone, mobile, website, address, about (boolean).

Hatalar

HTTP	error	Anlamı
`400`	`invalid`	Eksik ya da geçersiz alan (`message` ayrıntıyı verir).
`403`	`disabled`	Yönetici bu özelliği çalışma alanında kapattı (ör. dijital kartvizitler, arayan kimliği).

İstek

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

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

Yanıt