# İşletme profili

Tek bir endpoint, satıcının işletme profilinin herkese açık yüzünü döndürür: işletmenin adı ve iletişim bilgileri, kayıt bilgileri, bağladığı sosyal profiller ve içeriğinin yazıldığı diller. Storefront altbilgisi, iletişim sayfası veya dil seçici için kullanın. Satıcı bu değerleri panelde **Ayarlar** → **İşletme** altından düzenler.

Endpoint, `tenant:read` kapsamını taşıyan bir tenant API anahtarı ister ve `Authorization: Bearer {api_key}` olarak gönderilir. Hiçbir modüle bağlı değildir. Bu kapsamı taşımayan anahtar `403 {"message": "Invalid ability provided."}` alır. Dakikada 120 istek olan ortak tenant sınırı geçerlidir.

## GET /v1/api/business

İşletme profilinin herkese açık izin listesini döndürür. Banka, imzalayan, gönderici ve koşul alanları buna asla dahil değildir. Çağrı profil oluşturmaz: profilini henüz doldurmamış bir mağaza `200` ile yanıt verir, tüm metin alanları `null`, `social_links` `[]` ve varsayılan dil döner.

### Request

```bash title="Request"
curl https://api.borkol.com/v1/api/business \
  -H "Authorization: Bearer {api_key}"
```

### Response

```json title="Response"
{
  "data": {
    "trade_name": "Sunrise Bakery",
    "legal_name": "Sunrise Bakery BV",
    "email": "hello@bakery.example",
    "phone": "+31 20 123 4567",
    "website": "https://bakery.example",
    "street": "Kerkstraat",
    "house_number": "12",
    "postal_code": "2011 AB",
    "city": "Haarlem",
    "country": "NL",
    "registration_number": "12345678",
    "vat_id": "NL123456789B01",
    "social_links": [
      { "platform": "instagram", "url": "https://www.instagram.com/sunrisebakery", "label": null },
      { "platform": "other", "url": "https://bakery.example/blog", "label": "Blog" }
    ],
    "locale": "nl",
    "content_locales": ["nl", "en"]
  }
}
```

### Alanlar

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `trade_name` | string veya null | İşletmenin ticaret yaptığı ad. |
| `legal_name` | string veya null | Kayıtlı yasal ad. |
| `email` | string veya null | Herkese açık iletişim e-postası. |
| `phone` | string veya null | Herkese açık telefon numarası. |
| `website` | string veya null | İşletmenin kendi web sitesi. |
| `street` | string veya null | İşletme adresinin sokağı. |
| `house_number` | string veya null | Kapı numarası. |
| `postal_code` | string veya null | Posta kodu. |
| `city` | string veya null | Şehir. |
| `country` | string veya null | İki harfli ülke kodu, büyük harf, örneğin `NL`. |
| `registration_number` | string veya null | Ticaret sicil veya şirket kayıt numarası. |
| `vat_id` | string veya null | KDV numarası, büyük harf. |
| `social_links` | array | Satıcının bağladığı sosyal profiller, belirlediği sırayla. Yoksa boş array. Her öğe aşağıda açıklanmıştır. |
| `locale` | string | Mağazanın varsayılan dili, örneğin `nl` gibi bir dil etiketi. |
| `content_locales` | string array | Mağaza içeriğinin yazıldığı diller. Her zaman `locale` değerini içerir. Yerelleştirilmiş [Objects](/tr/api/objects/index#yerelletirilmi-deerler) değerlerinin kısaltıldığı listeyle aynıdır. |

### Sosyal bağlantı öğeleri

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `platform` | string | `instagram`, `facebook`, `x`, `linkedin`, `youtube`, `tiktok`, `pinterest`, `threads`, `bluesky`, `snapchat`, `whatsapp`, `telegram`, `github`, `behance`, `dribbble`, `vimeo`, `reddit`, `discord`, `mastodon`, `twitch`, `spotify`, `medium`, `other` değerlerinden biri. |
| `url` | string | Bir `https://` adresi. `mastodon` ve `other` dışındaki her platformda host o platforma aittir. |
| `label` | string veya null | Görüntülenen metin. `other` için her zaman vardır, diğerlerinde isteğe bağlıdır (çoğu zaman `null`). |

Platform listesi büyüyebilir. Tanımadığınız bir `platform` değerini sıradan bir bağlantı olarak ele alın ve `label` veya `url` ile gösterin.

### Hatalar

| Durum | Ne zaman |
| --- | --- |
| `401` | API anahtarı eksik veya geçersiz. |
| `403` | Anahtar `tenant:read` kapsamını taşımıyor. |
| `429` | Sınıra ulaşıldı. Bkz. [Hatalar ve sınırlar](/tr/api/getting-started/errors-and-rate-limits). |