ByCRM REST API

Her firmanın API'si kendi alan adında çalışır: https://firmakodu.bycrm.net/api/v1. Anahtarlar CRM içinde Entegrasyon > API Anahtarları bölümünden üretilir; ayrıntılı ve firmanıza özel doküman da orada bulunur.

Kimlik doğrulama

Authorization: Bearer 
Accept: application/json

Uç noktalar

GET /me	Anahtar sahibi ve yetkiler
GET /forms, GET /forms/{key}	Kayıt türleri ve alan şemaları
GET|POST /records/{form}	Listele (q, status, f[alan], sort, page) / oluştur
GET|PUT|PATCH|DELETE /records/{form}/{id}	Tek kayıt işlemleri
POST /records/{form}/{id}/comments	Not ekle
GET|POST /events	Takvim
GET /users	Aktif kullanıcılar
POST /hooks/{token}	Gelen webhook (otomasyon tetikleyici)

Örnek

curl -X POST https://firmakodu.bycrm.net/api/v1/records/musteriler \
  -H "Authorization: Bearer 1|xxxxx" -H "Content-Type: application/json" \
  -d '{"data":{"ad_soyad":"Ayşe Kaya","telefon":"05551112233","email":"[email protected]"}}'

Giden webhook'lar X-ByCRM-Signature (HMAC-SHA256) ile imzalanır. Limit: dakikada 120 istek, günlük limit pakete göre. Hatalar: 401, 402 (paket), 403, 422 (doğrulama), 429.