Ana içeriğe geç

Entegrasyon Listesi

Tüm entegrasyonları listeler.

Endpoint

GET /api/v1/integrations

Authentication

Bu endpoint authentication gerektirir.

Header: Authorization: Bearer \{token\}

Permission

  • integrations.view - Tüm entegrasyonları görüntüleme
  • integrations.view.own - Sadece kendi entegrasyonlarını görüntüleme

Request

Headers

HeaderDeğerZorunlu
AuthorizationBearer \{token\}Evet

Query Parameters

ParametreTipZorunluAçıklama
searchstringHayırGenel arama (name, UUID, provider)
typestringHayırEntegrasyon tipi (webhook, oauth, api)
providerstringHayırSağlayıcı adı
statusstringHayırDurum (active, inactive, error, pending)
is_activebooleanHayırAktif/pasif filtresi
with_trashedbooleanHayırSilinen entegrasyonları da dahil et
pageintegerHayırSayfa numarası (varsayılan: 1)
per_pageintegerHayırSayfa başına kayıt (varsayılan: 15, max: 100)

Response

Success Response (200 OK)

{
"data": [
{
"id": 1,
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"name": "Stripe Webhook",
"type": "webhook",
"provider": "stripe",
"description": "Stripe ödeme webhook entegrasyonu",
"status": "active",
"is_active": true,
"user_id": 1,
"user": {
"id": 1,
"email": "user@example.com"
},
"created_at": "2025-11-20T12:00:00.000000Z"
}
],
"current_page": 1,
"per_page": 15,
"total": 1,
"last_page": 1
}

Code Examples

cURL

curl -X GET https://api.example.com/api/v1/integrations \
-H "Authorization: Bearer \{token\}"

Filtreleme Örnekleri

# Belirli bir tip için
curl -X GET "https://api.example.com/api/v1/integrations?type=webhook" \
-H "Authorization: Bearer \{token\}"

# Belirli bir sağlayıcı için
curl -X GET "https://api.example.com/api/v1/integrations?provider=stripe" \
-H "Authorization: Bearer \{token\}"

# Aktif entegrasyonlar için
curl -X GET "https://api.example.com/api/v1/integrations?status=active" \
-H "Authorization: Bearer \{token\}"

Notes

  • Varsayılan olarak sadece aktif entegrasyonlar döner
  • .own permission'ı olan kullanıcılar sadece kendi entegrasyonlarını görür
  • Entegrasyonlar en yeni tarih sırasına göre döner (latest())
  • Entegrasyonlar kullanıcı bilgileri ile birlikte döner