# Başlangıç

İlk isteğinize üç adım.

### 1. API anahtarı oluşturun

Giriş yapın, Ayarlar > Geliştiriciler sayfasını açın ve bir anahtar oluşturun. Yalnızca gereken izinleri seçin (örneğin contacts.read). Anahtar bir kez gösterilir; güvenli bir yerde saklayın. Anahtar kendi çalışma alanında, onu oluşturan kişi olarak işlem yapar; o kişinin yapabileceğinden fazlasını asla yapamaz.

### 2. İlk isteğinizi gönderin

Anahtarı Authorization başlığına Bearer belirteci olarak koyun:

```bash
curl https://hubzone.app/api/open/v1/me \
  -H "Authorization: Bearer hzk_your_key_here"
```

### 3. Yanıtı okuyun

Her yanıt JSON'dur. Bu yanıt anahtarın neler yapabildiğini ve sınırlarını söyler:

```json
{
  "keyId": "3f0c8f0e-2b1a-4c55-9a38-0d6c1c9d7e11",
  "scopes": ["contacts.read", "contacts.write"],
  "limits": { "get": { "label": "Read one record", "perMinute": 600 } },
  "allScopes": 14
}
```

### Sonra: kayıt listeleyin ve oluşturun

```bash
# the properties (fields) of contacts, with their names and types
curl https://hubzone.app/api/open/v1/properties/contacts -H "Authorization: Bearer $HUBZONE_KEY"

# create a contact
curl -X POST https://hubzone.app/api/open/v1/objects/contacts \
  -H "Authorization: Bearer $HUBZONE_KEY" -H "content-type: application/json" \
  -d '{"properties":{"first_name":"Ada","last_name":"Lovelace","email":"ada@example.com"}}'

# the first 25 contacts that mention "ada"
curl "https://hubzone.app/api/open/v1/objects/contacts?limit=25&q=ada" -H "Authorization: Bearer $HUBZONE_KEY"
```

> Kayıt türleri: contacts, companies, deals, tickets, products, orders ve calls. Özellikler her zaman özellik adlarıyla gönderilir ve döner ("Özellik listesi" bölümüne bakın).