API Genel Bakış ve Kimlik Doğrulama

Enafeedback REST API için temel URL, kimlik doğrulama, hız sınırlama, hata kodları ve kurallar.

Enafeedback REST API'si, verileri programatik olarak okumanıza ve yazmanıza olanak tanır. Özel entegrasyonlar oluşturmak, verileri veri ambarınıza aktarmak veya çalışma alanı yönetim görevlerini otomatikleştirmek için kullanın.

Temel URL

https://api.enafeedback.com/api

Tüm uç noktalar /api ön ekine sahiptir. İstekler HTTPS kullanmalıdır.

Kimlik Doğrulama

Tüm API istekleri Bearer token gerektirir. Token edinmek için Kimlik Doğrulama sayfasına bakın.

Authorization: Bearer efa_sk_token_buraya

İstek Formatı

Content-Type — İstek gövdeleri için application/json.
Accept — application/json (varsayılan; tüm yanıtlar JSON formatındadır).
Tarihler — Saat dilimiyle ISO 8601, örn. 2026-06-07T10:30:00Z.

Yanıt Formatı

Başarılı yanıtlar HTTP 2xx ve JSON gövdesi döndürür. Liste uç noktaları sayfalanmış yanıtlar döndürür:

{
  "data": [...],
  "meta": {
    "total": 284,
    "page": 1,
    "per_page": 20,
    "pages": 15
  }
}

Tek kaynak yanıtları, kaynak nesnesini doğrudan döndürür.

Sayfalama

Herhangi bir liste uç noktasına ?page=2&per_page=50 ekleyin. Maksimum per_page 100'dür.

Filtreleme ve Sıralama

Çoğu liste uç noktası filtre sorgu parametrelerini kabul eder. Yaygın olanlar:

Parametre	Örnek	Açıklama
`from`	`2026-01-01T00:00:00Z`	Tarih aralığı başlangıcı
`to`	`2026-06-30T23:59:59Z`	Tarih aralığı sonu
`location_id`	`loc_abc123`	Konuma göre filtrele
`sort`	`created_at:desc`	Sıralama alanı ve yönü

Hata Kodları

HTTP Durumu	Anlamı
400 Bad Request	Geçersiz parametreler veya istek gövdesi
401 Unauthorized	Eksik veya geçersiz Bearer token
403 Forbidden	Geçerli token ancak yetersiz izinler
404 Not Found	Kaynak bu çalışma alanında mevcut değil
409 Conflict	Mükerrer kaynak veya kısıt ihlali
422 Unprocessable Entity	Doğrulama hatası (gövde alan düzeyinde hatalara sahip)
429 Too Many Requests	Hız sınırı aşıldı
500 Internal Server Error	Beklenmedik sunucu hatası

Hata yanıtları tutarlı bir yapıya sahiptir:

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Survey not found"
}

Hız Sınırlama

Çalışma alanı başına dakikada 1.000 istek. Başlık ayrıntıları için Kimlik Doğrulama sayfasına bakın.

Idempotency (Tekrarlanabilirlik)

Kaynak oluşturan POST istekleri varsayılan olarak idempotent değildir. Yeniden deneme sırasında mükerrer oluşturmayı önlemek için benzersiz bir dize (UUID önerilir) içeren bir Idempotency-Key başlığı ekleyin. 24 saatlik bir pencere içinde aynı anahtar, mükerrer oluşturmadan orijinal yanıtı döndürür.

Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

API Sürümleme

Mevcut API sürümü v1'dir (temel URL'de örtük). Kırıcı değişiklikler yeni bir temel URL yolu öneki (/api/v2) ile sunulacaktır. Kırıcı olmayan eklemeler (yeni alanlar, yeni isteğe bağlı parametreler) sürüm çarpmadan yapılabilir.

OpenAPI Spesifikasyonu

Bir OpenAPI 3.1 spesifikasyonu şu adreste mevcuttur:

https://api.enafeedback.com/api-docs-json

Otomatik oluşturulmuş istek şablonları ve yanıt şemaları için bunu Postman, Insomnia veya OpenAPI uyumlu herhangi bir istemciye içe aktarın.

API Genel Bakış ve Kimlik Doğrulama

Bu sayfada