Kimlik Dogrulama

DOLU.ai API'sine erisim icin kimlik dogrulama gereksinimleri.

Kimlik Dogrulama Yontemleri

API Anahtari

API istekleri icin Bearer token kullanin:

curl -X GET "https://api.dolu.ai/api/v1/contacts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

OAuth 2.0

Ucuncu taraf uygulamalar icin OAuth 2.0 destegi:

Authorization URL: https://api.dolu.ai/oauth/authorize
Token URL: https://api.dolu.ai/oauth/token

API Anahtari Olusturma

1. DOLU.ai'de Ayarlar > API'ye gidin
2. Yeni API Anahtari butonuna tiklayin
3. Anahtar icin bir isim girin
4. Izinleri secin
5. Olustur tiklayin
6. Anahtari guvenli bir yerde saklayin

Onemli: Anahtar sadece bir kez gosterilir!

Izinler

API anahtarlari icin kullanilabilir izinler:

Izin	Aciklama
contacts:read	Kisileri okuma
contacts:write	Kisi olusturma/guncelleme
conversations:read	Konusmalari okuma
conversations:write	Mesaj gonderme
deals:read	Firsatlari okuma
deals:write	Firsat olusturma/guncelleme
tasks:read	Gorevleri okuma
tasks:write	Gorev olusturma/guncelleme
analytics:read	Analitik verileri okuma

Token Yenileme

API anahtarlari surerz gecerlidir. Ancak:

• Anahtar iptal edilirse gecersiz olur
• Izinler degistirilirse yeniden olusturulmali
• Guvenlik ihlalinde hemen iptal edin

Hata Kodlari

Kod	Mesaj	Aciklama
401	Unauthorized	Gecersiz veya eksik token
403	Forbidden	Yeterli yetki yok
429	Too Many Requests	Rate limit asildi

Guvenlik Onerileri

1. Anahtarlari gizli tutun: Kod deposuna eklemeyin
2. Minimum izin: Sadece gerekli izinleri verin
3. IP kisitlama: Mumkunse IP beyaz listesi kullanin
4. Duzenli rotasyon: Anahtarlari periyodik degistirin
5. Audit log: API kullanimini izleyin

Ornek Kod

JavaScript/Node.js

const axios = require('axios');

const api = axios.create({
  baseURL: 'https://api.dolu.ai/api/v1',
  headers: {
    'Authorization': `Bearer ${process.env.DOLU_API_KEY}`,
    'Content-Type': 'application/json'
  }
});

// Kullanim
const contacts = await api.get('/contacts');

Python

import requests

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://api.dolu.ai/api/v1/contacts',
    headers=headers
)

PHP

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.dolu.ai/api/v1/contacts',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json'
    ],
    CURLOPT_RETURNTRANSFER => true
]);

$response = curl_exec($curl);