Integration Listele
Genel Bakış
Belirtilen node için sayfalanmış integration listesini döndürür. Sayfalama için page ve per_page sorgu parametrelerini kullanın.
Endpoint: GET /api/v1/integrations
Kimlik Doğrulama: Bearer token (JWT) gereklidir.
İstek
Başlıklar
| Başlık | Zorunlu | Açıklama |
|---|---|---|
Authorization | Evet | Bearer <jwt_token> |
Sorgu Parametreleri
| Parametre | Tip | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|---|
node_id | string | Evet | — | Integration'ları filtreleyecek node UUID |
page | int | Hayır | 1 | Sayfa numarası (1–10000) |
per_page | int | Hayır | 10 | Sayfa başına öğe (1–100, max 100) |
Yanıt
Başarı — 200 OK
| Alan | Tip | Açıklama |
|---|---|---|
items | IntegrationResponse[] | Integration listesi |
page | int | Mevcut sayfa numarası |
per_page | int | Sayfa başına öğe |
total | int64 | Toplam integration sayısı |
items içindeki her öğede:
| Alan | Tip | Açıklama |
|---|---|---|
id | string | Integration UUID |
node_id | string | Node UUID |
name | string | Integration adı |
api_key | string | API anahtarı |
permissions | string[] | İzin listesi |
expires_at | string | Son kullanma tarihi (veya null) |
created_at | string | Oluşturulma zaman damgası |
Örnek Yanıt
{
"items": [
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"node_id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Production API",
"api_key": "apex_abc123xyz456",
"permissions": ["payments.read", "payments.create"],
"expires_at": "2026-12-31T23:59:59Z",
"created_at": "2025-02-14T10:00:00Z"
}
],
"page": 1,
"per_page": 10,
"total": 42
}
Hata Yanıtları
| Kod | Açıklama |
|---|---|
400 | Geçersiz istek (doğrulama hatası) |
401 | Yetkisiz (eksik veya geçersiz token) |
500 | Sunucu hatası |
cURL Örneği
curl -X GET "https://api.example.com/api/v1/integrations?node_id=550e8400-e29b-41d4-a716-446655440000&page=1&per_page=10" \
-H "Authorization: Bearer JWT_TOKEN"