Integration Oluştur

Genel Bakış

Belirli bir node’a bağlı bir integration oluşturur (API key + secret). Secret sadece oluşturma sırasında bir kez döner — güvenli şekilde saklanmalıdır. API key ve secret oluşturulduktan sonra değiştirilemez.

Endpoint: POST /api/v1/integrations

Kimlik Doğrulama: Bearer token (JWT) gereklidir.

---

İstek

Başlıklar

Başlık	Zorunlu	Açıklama
Authorization	Evet	Bearer <jwt_token>
Content-Type	Evet	application/json

Gövde

Alan	Tip	Zorunlu	Doğrulama	Açıklama
node_id	string	Evet	UUID	Integration'ın ait olduğu node'un UUID'si
name	string	Evet	1–255 karakter	Integration'ın görünen adı
permissions	string[]	Hayır	—	İzin listesi (örn: payments.read, payments.create)
expires_at	string	Hayır	ISO 8601 tarih/saat	Opsiyonel son kullanma tarihi

Örnek İstek

{
  "node_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Production API",
  "permissions": ["payments.read", "payments.create"],
  "expires_at": "2026-12-31T23:59:59Z"
}

---

Yanıt

Başarı — 201 Created

Alan	Tip	Açıklama
id	string	Integration UUID
node_id	string	Node UUID
name	string	Integration adı
api_key	string	API anahtarı (örn: apex_abc123...)
secret	string	Düz metin secret — sadece create'te döner
permissions	string[]	İzin listesi
expires_at	string	Son kullanma tarihi (veya null)
created_at	string	Oluşturulma zaman damgası

Örnek Yanıt

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "node_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Production API",
  "api_key": "apex_abc123xyz456",
  "secret": "plain_secret_returned_only_once",
  "permissions": ["payments.read", "payments.create"],
  "expires_at": "2026-12-31T23:59:59Z",
  "created_at": "2025-02-14T10:00:00Z"
}

---

Hata Yanıtları

Kod	Açıklama
400	Geçersiz istek (doğrulama hatası)
401	Yetkisiz (eksik veya geçersiz token)
404	Node bulunamadı
409	Bu node için API key zaten mevcut
500	Sunucu hatası

---

cURL Örneği

curl -X POST https://api.example.com/api/v1/integrations \
  -H "Authorization: Bearer JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "node_id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Production API",
    "permissions": ["payments.read", "payments.create"]
  }'