Alt hesap oluşturma

Müşteriniz adına yeni bir alt hesap açmak için bu endpoint kullanılır. Yanıttaki api_key, alt hesap adına yapılacak tüm isteklerde kullanılır; id ise alt hesap ve kontör uçlarında alt hesabı belirtir (bkz. alt hesap adına istek göndermek).

Bu uç yalnızca Geliştirici paketindeki ana hesabın anahtarıyla çağrılır; alt hesabın anahtarıyla 403 döner.

İstek

POST /api/sub-accounts
Accept: application/json
Authorization: Bearer ANA_HESAP_API_KEY
Content-Type: application/json

İstek gövdesi

Alan	Tip	Zorunlu	Açıklama
name	string	Evet	Alt hesabın adı; panelde ve listelerde bu adla görünür (en fazla 255 karakter). Genelde müşterinizin firma adı yazılır.

Alt hesap açıldığında:

• Geliştirici Alt Hesabı paketi atanır; fatura ve yapay zeka hakları ana hesabınızdan düşer.
• Alt hesabın API anahtarı üretilir.
• Panel kurulum sihirbazı tamamlanmış sayılır, aylık rapor e-postası kapalı gelir.
• Ana hesaptaki yöneticiler alt hesaba otomatik eklenir; panelden Hesaba Geç ile alt hesaba geçebilirler.

Alt hesaba fatura hesabı otomatik eklenmez; fatura hesabı oluşturma ucunu alt hesabın anahtarıyla çağırarak ekleyin.

Örnek istekler

💻 cURL

curl -X POST "https://app.faturaentegrator.com/api/sub-accounts" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ANA_HESAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Örnek Ticaret Ltd. Şti."}'

🐘 PHP

<?php
$ch = curl_init('https://app.faturaentegrator.com/api/sub-accounts');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer ANA_HESAP_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['name' => 'Örnek Ticaret Ltd. Şti.']),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

🟢 Node.js

const res = await fetch('https://app.faturaentegrator.com/api/sub-accounts', {
  method: 'POST',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer ANA_HESAP_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ name: 'Örnek Ticaret Ltd. Şti.' }),
});
const data = await res.json();

🐍 Python

import requests
r = requests.post(
    'https://app.faturaentegrator.com/api/sub-accounts',
    headers={'Accept': 'application/json', 'Authorization': 'Bearer ANA_HESAP_API_KEY'},
    json={'name': 'Örnek Ticaret Ltd. Şti.'},
)
data = r.json()

Yanıt

201 ile oluşan alt hesap data altında döner:

{
  "data": {
    "id": 1234,
    "name": "Örnek Ticaret Ltd. Şti.",
    "parent_team_id": 42,
    "api_key": "x3Yf9kQ2...",
    "invoice_integrations_count": 0,
    "tenant": null,
    "created_at": "2026-11-06T09:00:00.000000Z"
  }
}

Alan	Açıklama
id	Alt hesap kimliği. Alt hesap detayı ve kontör yükleme uçlarında kullanılır.
name	Alt hesabın adı.
parent_team_id	Bağlı olduğu ana hesabın kimliği.
api_key	Alt hesabın API anahtarı; alt hesap adına yapılacak isteklerde Authorization: Bearer ile kullanılır. Anahtarı yenilemek için panelde alt hesaba geçip API sayfasını kullanın.
invoice_integrations_count	Alt hesaptaki fatura hesabı sayısı.
tenant	Alt hesabın e-Faturam firması; başvuru yoksa null. Alanlar için bkz. alt hesap listeleme.
created_at	Oluşturulma zamanı (ISO 8601).

API anahtarını güvenle saklayın

api_key, alt hesapta fatura kesmeye yetkili bir anahtardır. Müşterinize vermediğiniz sürece yalnızca kendi sunucunuzda saklayın.