{ "auth": { "bearer": [ { "key": "token", "type": "string", "value": "{{apiKey}}" } ], "type": "bearer" }, "info": { "description": "Tek kaynak sözleşme. Faz 0 iskeleti: yollar, işlemler, güvenlik, ortak başlıklar, RFC 9457 hata ve imleçli liste biçimi; gövde şemaları asgari.", "name": "KeenAuth Management API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "version": "1.0.0-faz0" }, "item": [ { "description": "`/v1/admin-portal-links` kaynak ailesi.", "item": [ { "name": "GET /v1/admin-portal-links", "request": { "description": "Ortamın Yönetici Portalı bağlantılarını yeniden eskiye imleçli listeler; `organization_id` ile tek org'un\nbağlantıları. Yalnız ileri sayfalama (`after`) vardır (`before` ve `order` `422`). Sayfa 1–100 kayıt, varsayılan\n20. İmleç süzgece bağlıdır; başka süzgecin imleci `400 invalid_cursor`'dır. Liste bağlantı URL'si döndürmez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "admin-portal-links" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Yalnız bu org'un bağlantıları (`org_…`).", "disabled": true, "key": "organization_id", "value": "" } ], "raw": "{{baseUrl}}/admin-portal-links" } } }, { "name": "POST /v1/admin-portal-links", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bir org'un BT yöneticisi için Yönetici Portalı bağlantısı üretir. `intents` portalın hangi\nbölümleri açacağıdır (`sso`, `dsync`, `domain_verification`, `certificate_renewal` her planda; `audit_logs`\nBusiness, `log_streams` Enterprise ister, yetmeyen planda `403 plan_feature_unavailable` `feature` ve\n`required_plan` ile). `return_url` mutlak `https` URL'sidir ve kökeni ortamdaki etkin bir uygulamanın kayıtlı\n`redirect_uri` kökeni olmalıdır (değilse `422 validation_failed`, `/return_url` `origin_not_registered`). Org bu\nortamda yoksa `404`. `delivery = link` (varsayılan) yanıtında `url` (`https:///portal/l/…`)\n5 dakika ve tek kullanım için geçerlidir, yalnız bu yanıtta bir kez döner ve `Cache-Control: no-store` taşır;\n`Idempotency-Key` ile tekrar oynatılan yanıtta `url` yoktur ve `secret_redacted: true` döner. `delivery = email`\nbir davettir: davet bağlantısı 7 gün geçerlidir ve yalnız `recipient_email` adresine gönderilen postadadır, yanıtta `url` ve alıcı\nadresi yoktur; alıcı bağlantıyı açınca aynı adrese 6 haneli bir kod gelir (10 dakika) ve portal oturumunu yalnız\ndoğrulanan kod açar. `recipient_email` yalnız ve her zaman `delivery = email` ile verilir (eksikse `422`\n`/recipient_email` `required`, `link` ile birlikteyse `not_allowed`, geçerli bir adres değilse `invalid_value`).\nDavet postası yazılamıyorsa `503 service_unavailable` (`Retry-After`) döner ve hiçbir bağlantı oluşturulmaz.\nOluşturma yönetim audit'ine `admin_portal_link.created` olarak düşer (URL, token ve alıcı adresi audit'e girmez).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "admin-portal-links" ], "raw": "{{baseUrl}}/admin-portal-links" } } }, { "name": "DELETE /v1/admin-portal-links/{link_id}", "request": { "description": "Bağlantıyı iptal eder; açtığı portal oturumları aynı anda düşer. Zaten iptal edilmiş bağlantıda da `204`\ndöner (idempotent; yeni audit kaydı yazılmaz). Bağlantı yoksa ya da başka ortamdaysa `404`. İptal yönetim\naudit'ine `admin_portal_link.revoked` olarak düşer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "admin-portal-links", ":link_id" ], "raw": "{{baseUrl}}/admin-portal-links/:link_id", "variable": [ { "description": "Yönetici Portalı bağlantısının önekli dış kimliği; biçim dışı kimlik `404`'tür.", "key": "link_id", "value": "" } ] } } } ], "name": "admin-portal-links" }, { "description": "`/v1/age-policy` tekil yapılandırma kaynağı (ortamın yaş politikası).", "item": [ { "name": "GET /v1/age-policy", "request": { "description": "Ortamın yaş politikasını döndürür.\nPolitika hiç yazılmadıysa tablo varsayılanları (`mode: off`, `min_age: 16`, boş ülke tablosu) ve `ETag: \"0\"`\ndöner; `updated_at` null'dır. Yanıt `ETag` başlığı taşır (`PUT` için `If-Match`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "age-policy" ], "raw": "{{baseUrl}}/age-policy" } } }, { "name": "PUT /v1/age-policy", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortamın yaş politikasının tamamını yazar. `If-Match` zorunludur (yoksa `428`, eşleşmezse `412`); politika\nhiç yazılmadıysa sürüm `\"0\"`'dır. Kurallar: `min_age` ve ülke eşikleri 13–21; ülke kodu ISO 3166-1 alpha-2\n(büyük harf), en çok 250 girdi; `parental_consent_below` null ya da 1..`min_age`; `store_birthdate` yalnız\n`mode = birthdate` iken `true`. Politika yalnız sonraki kayıtlara uygulanır; var olan kullanıcılar değişmez. Yetki\n`identity-settings:read|write`'tır: yaş politikası ortam kimlik ayarlarının parçasıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "age-policy" ], "raw": "{{baseUrl}}/age-policy" } } } ], "name": "age-policy" }, { "description": "`/v1/api-keys` kaynak ailesi.", "item": [ { "name": "GET /v1/api-keys", "request": { "description": "Ortamdaki yönetim API anahtarlarını imleçli olarak listeler (yeniden eskiye; `order=asc` ile tersi); iptal edilmiş ve süresi dolmuş anahtarlar dahildir. Ham anahtar hiçbir zaman dönmez; yalnız üst veri vardır (`last4`, son kullanım zamanı ve IP öneki).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "api-keys" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/api-keys" } } }, { "name": "POST /v1/api-keys", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortama yeni bir yönetim API anahtarı oluşturur. `type: secret` tüm yönetim API'sine erişir (`permissions` verilmez ya da boştur); `type: restricted` yalnız `permissions` listesindeki `:` izinlerini taşır (boş olamaz, en çok 200). `expires_at` zorunludur, gelecekte olmalı ve en çok 730 gün sonrasıdır; `allowed_cidrs` (en çok 20) verilirse anahtar yalnız bu ağlardan kabul edilir. Ham anahtar (`idp_sk_live_…`, `idp_sk_test_…`, `idp_rk_live_…`, `idp_rk_test_…`) YALNIZ bu yanıtta, bir kez `key` alanında döner ve sonradan hiçbir uçtan okunamaz (yanıt `Cache-Control: no-store` taşır). `Idempotency-Key` ile tekrar oynatılan yanıt (`Idempotent-Replayed: true`) anahtarı içermez: nesneyi `secret_redacted: true` ile döner; anahtar kaybedildiyse yenisi oluşturulur. Çağıranın kendi izinlerini aşan izinli anahtar oluşturulamaz ve kısıtlı (`restricted`) bir anahtar `secret` anahtar oluşturamaz; yeni anahtarın `expires_at` değeri çağıranınkinden sonra olamaz, `allowed_cidrs` taşıyan çağıran yalnız kendi ağlarının içindeki ağlarla sınırlı anahtar oluşturur (`allowed_cidrs` verilmezse çağıranın listesi kullanılır) (403 `permission_escalation`). Ortamda en çok 50 etkin anahtar olur; aşımda 409 `api_key_limit_reached`. `created_by` isteği yapan anahtarın (ya da pano aktörünün) kimliğidir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Bu işlemde zorunlu; yoksa 400 malformed_request.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "api-keys" ], "raw": "{{baseUrl}}/api-keys" } } }, { "name": "GET /v1/api-keys/{key_id}", "request": { "description": "Tek bir yönetim API anahtarının üst verisini döner; ham anahtar dönmez. Anahtar yoksa ya da başka ortamdaysa 404.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "api-keys", ":key_id" ], "raw": "{{baseUrl}}/api-keys/:key_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "key_id", "value": "" } ] } } }, { "name": "POST /v1/api-keys/{key_id}:revoke", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Anahtarı hemen iptal eder (kesindir, geri alınamaz; iptalden sonra en geç 30 sn içinde anahtar reddedilir). `reason` `manual` (varsayılan) ya da `leaked`; `leaked` sızıntı olarak işaretler. Döndürme aşamasındaki (iptali gelecekte olan) anahtar da hemen iptal edilir. Çağıranın izinlerini aşan anahtar iptal edilemez; panodan oluşturulmuş anahtarı yalnız kendisi ya da pano iptal eder (403 `permission_escalation`). Anahtar yoksa ya da başka ortamdaysa 404; zaten iptal edilmişse 409 `conflict`. Yanıt güncel `ApiKey` nesnesidir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "api-keys", "{{key_id}}:revoke" ], "raw": "{{baseUrl}}/api-keys/{{key_id}}:revoke" } } }, { "name": "POST /v1/api-keys/{key_id}:rotate", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Anahtarı döndürür: aynı ad, tür, izin ve `allowed_cidrs` ile YENİ bir anahtar oluşturur ve yeni anahtarı `ApiKeyCreated` olarak döner (`rotated_from` eski kimliktir; ham `key` yalnız bu yanıtta, bir kez, `Cache-Control: no-store`). Eski anahtar `overlap_hours` (0–168, varsayılan 24) saat daha geçerli kalır: `revoked_at` gelecekteki bir zamana, `revoke_reason` `rotated` olarak ayarlanır; 0 ise hemen iptal edilir. Yeni anahtarın `expires_at` değeri verilmezse şimdi + 365 gün, en çok çağıranın son kullanma anıdır (kendi anahtarını döndüren de ömrünü uzatamaz; ömür panodan uzatılır). Yeni anahtarın `created_by` değeri eski anahtarınkidir; döndüren anahtar audit kaydında görünür. `Idempotency-Key` ile tekrar oynatılan yanıt `key` içermez ve `secret_redacted: true` döner. Çağıranın izinlerini aşan anahtar döndürülemez ve kısıtlı bir anahtar `secret` anahtarı döndüremez; yeni anahtar çağırandan sonra sona eremez ve `allowed_cidrs` taşıyan çağıran ağları kendi ağlarının dışına çıkan anahtarı döndüremez; panodan oluşturulmuş anahtarı ve onun döndürülmüş haleflerini yalnız kendisi ya da pano döndürür ve iptal eder (403 `permission_escalation`). Anahtar yoksa ya da başka ortamdaysa 404; iptal edilmiş, süresi dolmuş ya da zaten döndürülmüş (etkin olmayan) anahtar için 409 `conflict`; etkin anahtar sınırı aşılırsa 409 `api_key_limit_reached`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "api-keys", "{{key_id}}:rotate" ], "raw": "{{baseUrl}}/api-keys/{{key_id}}:rotate" } } } ], "name": "api-keys" }, { "description": "`/v1/apis` kaynak ailesi.", "item": [ { "name": "GET /v1/apis", "request": { "description": "Ortamdaki API'leri (kaynak sunucular) imleçli sayfalarla listeler; silinmiş API'ler listelenmez. Ortam yalnız kimlik bilgisinden gelir. Sıralama `created_at` + `id` ile kararlıdır (`order`, varsayılan `desc`). Sistem API'si (`urn:idp:organization`) listede yer alır ve `is_system: true` taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "apis" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/apis" } } }, { "name": "POST /v1/apis", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortamda yeni bir API oluşturur. `key`, `identifier` ve `name` zorunludur; `identifier` https URL ya da `urn::` olur, kanonik biçime çevrilir ve ortamda (silinmişleri de 90 gün sayarak) tekildir; `urn:idp:` ad alanı platforma ayrılmıştır. Verilmeyen alan varsayılanını alır (`mcp_profile` ise jeton ömrü 600 sn ve `require_resource_indicator` true). Yanıtta `ETag` döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "apis" ], "raw": "{{baseUrl}}/apis" } } }, { "name": "GET /v1/apis/{api_id}", "request": { "description": "Tek bir API'yi döndürür; yanıtta güncel sürümü gösteren `ETag` başlığı bulunur. Başka ortamın, silinmiş ya da biçimsiz kimlik `404 not_found` olur (varlık sızdırılmaz).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "apis", ":api_id" ], "raw": "{{baseUrl}}/apis/:api_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "api_id", "value": "" } ] } } }, { "name": "DELETE /v1/apis/{api_id}", "request": { "description": "API'yi yumuşak siler: `?confirm=true` zorunludur ve `If-Match` ister (yoksa `428`, eşleşmezse `412`). Uygulamaların bu API'ye verilmiş izinleri ve `default_api` değerleri aynı işlemde kaldırılır; tanımlayıcı 90 gün yeniden kullanılamaz; bu API'nin kitlesine (`aud`) bağlı refresh aileleri iptal edilir. Sistem API'si silinemez (`409 conflict`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "apis", ":api_id" ], "query": [ { "description": "Silme onayı; yalnız `true` kabul edilir, yoksa ya da başka değerse 422 validation_failed (`/confirm`).", "key": "confirm", "value": "" } ], "raw": "{{baseUrl}}/apis/:api_id?confirm=", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "api_id", "value": "" } ] } } }, { "name": "PATCH /v1/apis/{api_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "API'yi RFC 7396 birleştirme yamasıyla günceller (`application/merge-patch+json`). `If-Match` zorunludur: yoksa `428`, güncel sürümle eşleşmezse `412`. `key` ve `identifier` oluşturulduktan sonra değişmez; sistem API'si (`urn:idp:organization`) değiştirilemez (`409 conflict`). Yamada bulunmayan alan korunur; zorunlu alanı `null` yapmak `422` verir. Değişiklik yoksa yazma yapılmaz ve sürüm artmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "apis", ":api_id" ], "raw": "{{baseUrl}}/apis/:api_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "api_id", "value": "" } ] } } }, { "name": "GET /v1/apis/{api_id}/authorization-detail-types/{type}", "request": { "description": "İskelet işlem; davranış plan satırındadır. Not: izin planda yazılmamış", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "apis", ":api_id", "authorization-detail-types", ":type" ], "raw": "{{baseUrl}}/apis/:api_id/authorization-detail-types/:type", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "api_id", "value": "" }, { "description": "Yol anahtarı.", "key": "type", "value": "" } ] } } }, { "name": "PUT /v1/apis/{api_id}/authorization-detail-types/{type}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: izin planda yazılmamış", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "apis", ":api_id", "authorization-detail-types", ":type" ], "raw": "{{baseUrl}}/apis/:api_id/authorization-detail-types/:type", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "api_id", "value": "" }, { "description": "Yol anahtarı.", "key": "type", "value": "" } ] } } }, { "name": "DELETE /v1/apis/{api_id}/authorization-detail-types/{type}", "request": { "description": "İskelet işlem; davranış plan satırındadır. Not: izin planda yazılmamış", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "apis", ":api_id", "authorization-detail-types", ":type" ], "raw": "{{baseUrl}}/apis/:api_id/authorization-detail-types/:type", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "api_id", "value": "" }, { "description": "Yol anahtarı.", "key": "type", "value": "" } ] } } } ], "name": "apis" }, { "description": "`/v1/applications` kaynak ailesi.", "item": [ { "name": "GET /v1/applications", "request": { "description": "Ortamdaki uygulamaları imleçli olarak listeler (yeniden eskiye; order=asc ile tersi). app_type ve status ile süzülebilir; imleç süzgeçle birlikte imzalıdır, süzgeç değişirse eski imleç 400 invalid_cursor döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" }, { "description": "Uygulama türüne göre süz.", "disabled": true, "key": "app_type", "value": "" }, { "description": "Duruma göre süz.", "disabled": true, "key": "status", "value": "" } ], "raw": "{{baseUrl}}/applications" } } }, { "name": "POST /v1/applications", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Yeni uygulama (OAuth/OIDC istemcisi) oluşturur. Ortam kimlik bilgisinden gelir. key, name, app_type ve party zorunludur; verilmeyen protokol alanları türden türetilen güvenli varsayılanı alır. Yanıttaki ETag güncelleme ve silmede If-Match olarak kullanılır. `allowed_first_factors` ortamın birinci faktör kümesiyle ortak yöntem bırakmıyorsa 422 policy_conflict döner. İstemci sırrı bu uçta üretilmez; sırlar ve anahtarlar uygulama kimlik bilgisi uçlarındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications" ], "raw": "{{baseUrl}}/applications" } } }, { "name": "GET /v1/applications/{application_id}", "request": { "description": "Uygulamayı döndürür. Başka ortamın ya da var olmayan uygulama 404 döner. Yanıttaki ETag güncelleme ve silmede If-Match olarak kullanılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", ":application_id" ], "raw": "{{baseUrl}}/applications/:application_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "DELETE /v1/applications/{application_id}", "request": { "description": "Uygulamayı siler; yönlendirme URI'leri, API izinleri ve bağlantı listesi birlikte silinir. If-Match zorunludur: yoksa 428, sürüm eşleşmezse 412.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", ":application_id" ], "raw": "{{baseUrl}}/applications/:application_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "PATCH /v1/applications/{application_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Uygulamayı merge-patch (RFC 7396) ile günceller. If-Match zorunludur: yoksa 428, sürüm eşleşmezse 412. Değişmez alanlar (key, app_type, registration_source, owner_org_id) farklı değerle gelirse 422 döner. Hiçbir alanı değiştirmeyen yama kaydı değiştirmez ve sürümü artırmaz. `allowed_first_factors` ortamın birinci faktör kümesiyle ortak yöntem bırakmıyorsa 422 policy_conflict döner; boş liste kısıtı kaldırır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", ":application_id" ], "raw": "{{baseUrl}}/applications/:application_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "GET /v1/applications/{application_id}/api-grants/{api_id}", "request": { "description": "Uygulamanın bir API'deki izinli ve varsayılan scope kümesini döndürür. İzin yoksa 404 döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", ":application_id", "api-grants", ":api_id" ], "raw": "{{baseUrl}}/applications/:application_id/api-grants/:api_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "api_id", "value": "" } ] } } }, { "name": "PUT /v1/applications/{application_id}/api-grants/{api_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Uygulamanın bir API'deki izinli scope kümesini bütünüyle değiştirir. Scope'lar API'nin tanımlı izinlerinin alt kümesi, default_scopes ise scopes'un alt kümesi olmalıdır. Uygulama başına en çok 50 API izni verilebilir; aşılırsa 403 quota_exceeded döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", ":application_id", "api-grants", ":api_id" ], "raw": "{{baseUrl}}/applications/:application_id/api-grants/:api_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "api_id", "value": "" } ] } } }, { "name": "DELETE /v1/applications/{application_id}/api-grants/{api_id}", "request": { "description": "Uygulamanın bir API'deki iznini siler. İzin yoksa 404 döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", ":application_id", "api-grants", ":api_id" ], "raw": "{{baseUrl}}/applications/:application_id/api-grants/:api_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "api_id", "value": "" } ] } } }, { "name": "PUT /v1/applications/{application_id}/connections", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Uygulamada etkin bağlantı listesini bütünüyle değiştirir. Liste sıralıdır: barındırılan girişte düğme sırası buradan gelir. Boş liste bütün bağlantıları kapatır. En çok 100 bağlantı, tekrarsız. Her bağlantı bu ortamın bağlantısı olmalıdır; başka ortamın ya da var olmayan bağlantı `422` (`/connection_ids`) döner ve hiçbir şey yazılmaz. Aynı liste yeniden yazılmaz, sürüm artmaz. `If-Match` isteğe bağlıdır: verilirse uygulamanın sürümüyle eşleşmelidir (`412`). Hem `applications:write` hem `connections:write` izni gerekir. Yanıt güncel uygulamayı ve `ETag`'i taşır; değişiklik yönetim audit'ine `application.updated` olarak yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", ":application_id", "connections" ], "raw": "{{baseUrl}}/applications/:application_id/connections", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "GET /v1/applications/{application_id}/credentials", "request": { "description": "Uygulamanın kimlik bilgilerini (istemci sırları ve kayıtlı açık anahtarlar) tek sayfada listeler; iptal edilmiş ve süresi dolmuş kayıtlar dahildir, en yeni başta. Sır, sır özeti ve JWK gövdesi asla dönmez; yalnız üst veri (`secret_last4` ya da `jwk_thumbprint`, son kullanım zamanı) vardır. Bir uygulamada en çok 2 etkin sır ve 5 etkin anahtar olabildiğinden liste imleçsizdir: `limit`, `after`, `before`, `order` yoktur ve `list_metadata` her zaman `null` döner. Uygulama bu ortamda yoksa 404 döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", ":application_id", "credentials" ], "raw": "{{baseUrl}}/applications/:application_id/credentials", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "POST /v1/applications/{application_id}/credentials", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Uygulamaya yeni bir kimlik bilgisi ekler. Uygulama türüne göre izinli: `client_secret` yalnız `web` ve `m2m`; `public_key` `web`, `m2m`, `device` ve `management`; açık istemciler (`spa`, `native`) kimlik bilgisi almaz (aksi `422 validation_failed`, `/type: not_allowed`). `type: client_secret` platformca üretilen bir istemci sırrı oluşturur (isteğe bağlı `expires_at`, gelecekte olmalı); sır YALNIZ bu yanıtta, bir kez `client_secret` alanında döner ve sonradan hiçbir uçtan okunamaz (yanıt `Cache-Control: no-store` taşır). `type: public_key` `private_key_jwt` için bir açık anahtar (`jwk`, RFC 7517, en çok 16 KiB) kaydeder; özel ya da simetrik üye (`d`, `p`, `q`, `dp`, `dq`, `qi`, `oth`, `k`) içeren anahtar 422 ile reddedilir ve anahtarın kimliği RFC 7638 `jwk_thumbprint`'idir. Uygulama başına en çok 2 etkin sır ve 5 etkin anahtar olur; aşımda 409 `credential_limit_reached` döner (rotasyon: yenisini ekle, eskisini sil). Aynı anahtar zaten kayıtlıysa 409 `conflict`. `Idempotency-Key` ile tekrar oynatılan yanıt (`Idempotent-Replayed: true`) sır içermez: kimlik bilgisi nesnesini `secret_redacted: true` ile döner; sır kaybedildiyse yenisi oluşturulur. `created_by` isteği yapan anahtarın kimliğidir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", ":application_id", "credentials" ], "raw": "{{baseUrl}}/applications/:application_id/credentials", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "DELETE /v1/applications/{application_id}/credentials/{credential_id}", "request": { "description": "Kimlik bilgisini `manual` nedeniyle iptal eder (kesindir, geri alınamaz; iptalden sonra en geç 30 sn içinde istemci kimlik doğrulaması reddedilir). Aynı nedenle tekrar çağrı 204 döner. Kimlik bilgisi başka bir uygulamaya aitse ya da yoksa 404; başka nedenle (leaked, policy, expired, application_deleted) zaten iptal edilmişse 409 `conflict`. Etkin sayıyı düşürür: 2 sır ya da 5 anahtar sınırındaki uygulamada yeni kimlik bilgisi eklemenin yolu eskisini silmektir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", ":application_id", "credentials", ":credential_id" ], "raw": "{{baseUrl}}/applications/:application_id/credentials/:credential_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "credential_id", "value": "" } ] } } }, { "name": "POST /v1/applications/{application_id}/tokens:revoke", "request": { "description": "Uygulamanın bütün etkin refresh token ailelerini iptal eder; uygulamaya verilmiş canlı access token'lar introspection ve iptal denetiminde artık kabul edilmez. Kimlik bilgisi sızıntısında ya da yönetici kararıyla kullanılır. Oturumlar, kullanıcı onayları ve istemci kimlik bilgileri değişmez; sızan sırrı kapatmak için kimlik bilgisi ayrıca döndürülür. Gövde yoktur. Uygulama bu ortamda yoksa 404 döner. Tekrar çağrı başarıdır. İptal yönetim audit'ine yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", ":application_id", "tokens:revoke" ], "raw": "{{baseUrl}}/applications/:application_id/tokens:revoke", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "POST /v1/applications/{application_id}:resume", "request": { "description": "Askıdaki uygulamayı yeniden etkinleştirir (`status` = `active`); uygulama yeniden token alabilir. Gövde yoktur (boş ya da `{}`). Uygulama zaten etkinse hiçbir şey yazılmaz, sürüm artmaz ve mevcut kaynak 200 ile döner. `If-Match` isteğe bağlıdır (eşleşmezse `412`); verilmezse yarışta işlem birkaç kez yeniden denenir. Yanıt güncel uygulamayı ve `ETag`'i taşır; değişiklik yönetim audit'ine `application.updated` olarak yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", "{{application_id}}:resume" ], "raw": "{{baseUrl}}/applications/{{application_id}}:resume" } } }, { "name": "POST /v1/applications/{application_id}:suspend", "request": { "description": "Uygulamayı askıya alır (`status` = `suspended`). Askıdaki uygulama yeni token alamaz: yetkilendirme, PAR, cihaz akışı ve token ucu (refresh token ve client_credentials dahil) istemciyi reddeder (`invalid_client`). Verilmiş access token'lar kendi ömürleri kadar yaşar; anlık kesim isteyen kaynak sunucu introspection kullanır. Mevcut refresh token aileleri bu işlemle iptal edilmez: askı süresince kullanılamaz, uygulama yeniden etkinleştirilince yeniden kullanılabilir. Gövde yoktur (boş ya da `{}`). Uygulama zaten askıdaysa hiçbir şey yazılmaz, sürüm artmaz ve mevcut kaynak 200 ile döner. `If-Match` isteğe bağlıdır (eşleşmezse `412`); verilmezse başka bir yazarla yarışta işlem birkaç kez yeniden denenir. Yanıt güncel uygulamayı ve `ETag`'i taşır; değişiklik yönetim audit'ine `application.updated` olarak yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications", "{{application_id}}:suspend" ], "raw": "{{baseUrl}}/applications/{{application_id}}:suspend" } } }, { "name": "POST /v1/applications:create-registration-token", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "applications:create-registration-token" ], "raw": "{{baseUrl}}/applications:create-registration-token" } } } ], "name": "applications" }, { "description": "`/v1/attack-protection` kaynak ailesi.", "item": [ { "name": "GET /v1/attack-protection", "request": { "description": "Saldırı koruması nesnesi.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "attack-protection" ], "raw": "{{baseUrl}}/attack-protection" } } }, { "name": "PUT /v1/attack-protection", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Saldırı koruması nesnesi.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "attack-protection" ], "raw": "{{baseUrl}}/attack-protection" } } }, { "name": "PATCH /v1/attack-protection", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Saldırı koruması nesnesi.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "attack-protection" ], "raw": "{{baseUrl}}/attack-protection" } } }, { "name": "GET /v1/attack-protection/attack-mode", "request": { "description": "Ortamın saldırı modu durumunu ve son 90 günde başlamış ya da hâlâ açık dönemlerini en yenisi önce (en çok 100) döner; `more` daha eski dönem olduğunu bildirir. `active` yalnız uygulanan (`would_have = false`) ve bütün ortamı kapsayan bir dönem varken doğrudur; `log` kipindeki tetik `would_have = true` dönem olarak görünür. Bitişi geçmiş ama henüz kapatılmamış dönem `ended_at = ends_at` ile okunur. Dönemi kimin açtığı yanıtta yoktur; yönetim audit'indedir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "attack-protection", "attack-mode" ], "raw": "{{baseUrl}}/attack-protection/attack-mode" } } }, { "name": "POST /v1/attack-protection/attack-mode:activate", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Müşterinin elle saldırı modu dönemini `duration_minutes` (15–1.440) için açar; açık bir elle dönem varsa bitişini şimdi + süreye öteler, daha kısa süre dönemi kısaltmaz. Açılışta `attack_mode_activated` olayı ve yönetim audit kaydı (`attack_mode.activated`), uzatmada yalnız audit kaydı (`attack_mode.extended`) aynı transaction'da yazılır. Elle dönem `bot_protection.mode` ne olursa olsun uygulanır. Aktör yalnız doğrulanmış kimlik bilgisinden gelir. Yanıt güncel durumdur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "attack-protection", "attack-mode:activate" ], "raw": "{{baseUrl}}/attack-protection/attack-mode:activate" } } }, { "name": "POST /v1/attack-protection/attack-mode:deactivate", "request": { "description": "Müşterinin açık elle saldırı modu dönemini şimdi kapatır (`attack_mode_deactivated` olayı ve yönetim audit kaydı `attack_mode.deactivated`). Otomatik ve platform dönemleri erken kapanmaz: açıksa yanıt `active: true` kalır. Kapatılacak elle dönem yoksa hiçbir şey yazılmaz ve durum döner; işlem idempotenttir. Yanıt güncel durumdur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "attack-protection", "attack-mode:deactivate" ], "raw": "{{baseUrl}}/attack-protection/attack-mode:deactivate" } } }, { "name": "GET /v1/attack-protection/lockouts", "request": { "description": "Ortamın açık ve süresi dolmamış hesap kilitlerini kimlik sırasıyla, en eskisi önce imleçli listeler; yalnız ileri sayfalama vardır (`before` ve `order=desc` `422`). Süresi dolmuş ama kapanmamış kilit listelenmez: yolu artık kapatmaz. Yanıt sayaç öznesi, adres ya da IP taşımaz; toplam sayı döndürülmez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "attack-protection", "lockouts" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/attack-protection/lockouts" } } }, { "name": "DELETE /v1/attack-protection/lockouts/{lockout_id}", "request": { "description": "Tek hesap kilidini kapatır: kilit `cleared_by = admin:` ile kapanır, kullanıcının o yoldaki sayacı silinir, aynı transaction'da `user.unlocked` olayı ve yönetim audit kaydı (`user.unlocked`, hedef kullanıcı) yazılır. Kilit yoksa, başka ortamınsa, kapanmışsa ya da süresi dolmuşsa `404`. Aktör yalnız doğrulanmış kimlik bilgisinden gelir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "attack-protection", "lockouts", ":lockout_id" ], "raw": "{{baseUrl}}/attack-protection/lockouts/:lockout_id", "variable": [ { "description": "Kilidin önekli dış kimliği (`lck_…`).", "key": "lockout_id", "value": "" } ] } } } ], "name": "attack-protection" }, { "description": "`/v1/audit-events` kaynak ailesi.", "item": [ { "name": "GET /v1/audit-events", "request": { "description": "Yönetim audit'i kayıtlarını süzgeçle imleçli listeler; sıralama her zaman `occurred_at` azalandır (eşitlikte `id` azalan), `order` parametresi yoktur. `stream` varsayılanı `admin`dir. `to` yoksa şimdi, `from` yoksa saklama penceresinin başı ile `to` − 92 günden geç olanıdır; aralık [`from`, `to`) en çok 92 gündür (aşımda `400 invalid_filter`), saklama penceresi dışındaki `from` ya da `to` `400 range_outside_retention` döner. Saklama ortamın planından sunucuda uygulanır. `action` önek eşleşmesidir; `target_type` ile `target_id` birlikte verilirse ikisi aynı hedef öğesinde eşleşir; `agent_only=true` yalnız ajan eylemlerini döner; `client=mcp` ya da `client=cli` çağrıyı yapan istemcinin sınıfıyla süzer. Sorgu 10 sn'yi aşarsa `422 search_too_broad` döner: süzgeç ya da aralık daraltılmalıdır. Toplam sayı döndürülmez; imleç yalnız üretildiği süzgeç ve ortamla geçerlidir. Görünürlük: `ip` ve `user_agent` yalnız kimlik bilgisi `audit-events:read_ip` iznini taşıyorsa yanıtta bulunur ve yalnız 13 aydan yeni kayıtta doludur; izin yoksa alan hiç yazılmaz (maskeli değer dönmez). `ip_prefix`, `ip_country`, `ip_asn` ve `user_agent_family` her zaman döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "audit-events" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "description": "Akış: `admin` (yönetim API'si, pano ve platform değişiklikleri) ya da `application`. Varsayılan `admin`.", "disabled": true, "key": "stream", "value": "" }, { "description": "Dahil alt sınır (RFC 3339). Yoksa saklama penceresinin başı ile `to` − 92 günden geç olanı; pencere dışı değer `400 range_outside_retention` döner.", "disabled": true, "key": "from", "value": "" }, { "description": "Hariç üst sınır (RFC 3339). Yoksa şimdi; `from` verilmişse ondan sonra olmalıdır ve aralık en çok 92 gündür.", "disabled": true, "key": "to", "value": "" }, { "description": "Eylem öneki (`user.` ya da `connection.updated`).", "disabled": true, "key": "action", "value": "" }, { "description": "Kayıt kategorisi.", "disabled": true, "key": "category", "value": "" }, { "description": "Aktör türü (`dashboard_user`, `api_key`, `m2m_client`, `end_user`, `scim_directory`, `agent`, `staff`, `system`, `anonymous`; `application` akışında müşteri tanımlı türler).", "disabled": true, "key": "actor_type", "value": "" }, { "description": "Aktörün kayıttaki kimliği (`key_…`, `usr_…`, `du_…`, `system:`); tam eşleşme.", "disabled": true, "key": "actor_id", "value": "" }, { "description": "Hedef türü (`user`, `organization`, `connection`, `audit_export` …).", "disabled": true, "key": "target_type", "value": "" }, { "description": "Hedefin kayıttaki kimliği; `target_type` ile birlikte verilirse ikisi aynı hedef öğesinde eşleşir.", "disabled": true, "key": "target_id", "value": "" }, { "description": "Organizasyon (`org_` önekli dış kimlik).", "disabled": true, "key": "org_id", "value": "" }, { "description": "Kaydın sonucu.", "disabled": true, "key": "outcome", "value": "" }, { "description": "İsteğin `Idp-Request-Id` değeri (UUID); hata ekranındaki kimlikle doğrudan arama.", "disabled": true, "key": "request_id", "value": "" }, { "description": "İş akışının `Idp-Correlation-Id` değeri (UUID).", "disabled": true, "key": "correlation_id", "value": "" }, { "description": "`true` ise yalnız ajan eylemleri: `actor_type = agent` ya da `act_chain` dolu.", "disabled": true, "key": "agent_only", "value": "" }, { "description": "Çağrıyı yapan istemcinin sınıfı: `mcp` yönetim MCP sunucusu (`metadata.client` = `mcp/`), `cli` KeenAuth CLI (`cli/`). Değer istemcinin beyanıdır, yetki kanıtı değildir; sorumluluk kaydın aktöründedir. Yalnız listede; dışa aktarma gövdesinde yoktur.", "disabled": true, "key": "client", "value": "" } ], "raw": "{{baseUrl}}/audit-events" } } }, { "name": "POST /v1/audit-events", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Bu işlemde zorunlu; yoksa 400 malformed_request.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "audit-events" ], "raw": "{{baseUrl}}/audit-events" } } }, { "name": "GET /v1/audit-events/{event_id}", "request": { "description": "Tek yönetim audit'i kaydını (iki akıştan) döner. Kayıt yoksa, başka ortamınsa ya da saklaması bitmişse `404 not_found` döner; biçimsiz kimlik de aynı yanıtı alır. Görünürlük `GET /v1/audit-events` ile aynıdır: `ip` ve `user_agent` yalnız `audit-events:read_ip` izniyle yanıtta bulunur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "audit-events", ":event_id" ], "raw": "{{baseUrl}}/audit-events/:event_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "event_id", "value": "" } ] } } }, { "name": "POST /v1/audit-events:batch", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Bu işlemde zorunlu; yoksa 400 malformed_request.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "audit-events:batch" ], "raw": "{{baseUrl}}/audit-events:batch" } } } ], "name": "audit-events" }, { "description": "`/v1/audit-exports` kaynak ailesi.", "item": [ { "name": "POST /v1/audit-exports", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Yönetim audit'inin imzalı, platforma güvenmeden doğrulanabilir dışa aktarma işini kuyruğa koyar ve işi `202` ile döner; durum `GET /v1/audit-exports/{export_id}` ile izlenir. Süzgeçler `GET /v1/audit-events` ile aynıdır; farkı: 92 gün sınırı yoktur (iş başına en çok 50 milyon satır), `from` yoksa saklama penceresinin başı, `to` yoksa şimdidir ve `to` gelecekte olamaz. `include_ip: true` tam IP ve user-agent'ı (yalnız 13 aydan yeni kayıtlarda) satırlara ekler ve `audit-events:read_ip` izni de ister (yoksa `403 insufficient_permissions`). Ortam başına en çok 3 (development ve staging ortamında 1) eşzamanlı iş çalışır; aşımda `429 rate_limited`. `Idempotency-Key` zorunludur: aynı anahtar ve aynı gövde ilk işi `Idempotent-Replayed: true` ile döner, aynı anahtar farklı gövdeyle `422 idempotency_key_reuse` alır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Bu işlemde zorunlu; yoksa 400 malformed_request.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "audit-exports" ], "raw": "{{baseUrl}}/audit-exports" } } }, { "name": "GET /v1/audit-exports/{export_id}", "request": { "description": "Dışa aktarma işinin durumunu döner: `queued`, `running`, `completed`, `failed` ya da `expired`. `record_count`, `file` ve `manifest_sha256` yalnız `completed` ve `expired` işte, `failure_reason` yalnız `failed` işte doludur. Dosya `expires_at` anında (`completed_at` + 7 gün) silinir. İş yoksa ya da başka ortamınsa `404 not_found` döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "audit-exports", ":export_id" ], "raw": "{{baseUrl}}/audit-exports/:export_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "export_id", "value": "" } ] } } }, { "name": "GET /v1/audit-exports/{export_id}/download", "request": { "description": "Tamamlanmış işin paketine tek kullanımlık indirme bağlantısı verir. İstek `Accept` başlığında `application/json`'ı açıkça listeliyorsa (q > 0; joker medya türleri sayılmaz) yanıt `200` ve `AuditExportDownloadLink` gövdesidir: `url` aşağıdaki `Location`'ın aynısıdır, `expires_at` belirtecin son geçerlilik anıdır; kökenler arası tarayıcı istemcisi (pano) bağlantıyı böyle okur ve tarayıcıyı ona yönlendirir. Öteki isteklerde yanıt `302`'dir: `Location` 15 dakika geçerli, tek kullanımlık belirteç taşıyan `api` indirme adresidir (dosya ortam DEK'iyle şifreli olduğundan nesne deposunun ön imzalı URL'si verilmez). Hedef `/v1` dışındadır ve kimlik bilgisi istemez: belirteç tek kimlik bilgisidir, ilk açılışta harcanır (aktarım yarıda kalsa da) ve `Location` gizli tutulmalıdır. Hedef `200` ile `application/x-tar` gövdesi (`Content-Disposition: attachment; filename=\"audit-export-aex_….tar\"`, `Referrer-Policy: no-referrer`) döner: `records.ndjson.gz`, `manifest.json` (RFC 8785) ve `manifest.jws` (`audit-jwks.json` ile doğrulanır); belirteç geçersiz, kullanılmış ya da süresi dolmuşsa `404 not_found`. Her çağrı (iki dalda da) bağlantı verilmeden önce `admin` akışına `audit_export.downloaded` kaydı yazar; iki yanıt da `Vary: Accept`, `Referrer-Policy: no-referrer` ve `Cache-Control: no-store` taşır, izin ve adım yükseltme kuralları aynıdır. `include_ip` ile oluşturulmuş işin dosyası `audit-events:read_ip` izni de ister (yoksa `403 insufficient_permissions`). İş tamamlanmamışsa ya da dosyanın süresi dolmuşsa `409 conflict`, iş yoksa `404 not_found` döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "audit-exports", ":export_id", "download" ], "raw": "{{baseUrl}}/audit-exports/:export_id/download", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "export_id", "value": "" } ] } } } ], "name": "audit-exports" }, { "description": "`/v1/branding` kaynak ailesi.", "item": [ { "name": "GET /v1/branding", "request": { "description": "Ortamın markalama taslağını döndürür: tema jetonları (`theme`; yalnız ayarlı jetonlar, ayarsız jeton platform\nvarsayılanından miras alır), özel CSS ve sayfa şablonu (yoksa `null`). Taslak yayımlanana dek barındırılan sayfalarda\ngörünmez (`POST /v1/branding:publish`). Taslak hiç yazılmadıysa boş tema, `updated_at: null` ve `ETag: \"0\"` döner;\nyanıt `ETag` başlığı `PATCH`, `PUT /v1/branding/css` ve `PUT /v1/branding/page-template` için `If-Match` değeridir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding" ], "raw": "{{baseUrl}}/branding" } } }, { "name": "PATCH /v1/branding", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortam temasını RFC 7396 birleştirme yamasıyla günceller (`application/merge-patch+json`). Gövde yalnız `theme`\ntaşır; bir jetona `null` vermek onu temizler (platform varsayılanına döner), bir gruba (`light`, `dark`, `light.color`,\n`font`, `radius`) `null` vermek altındaki bütün jetonları temizler. `If-Match` zorunludur (yoksa `428`, eşleşmezse `412`;\ntaslak yoksa `\"0\"`). Geçersiz jeton `422 validation_failed` ve `/theme/...` işaretçisiyle döner (kodlar: `invalid_value`,\n`out_of_range`, `unknown_token`). Kontrast yazmada değil yayında denetlenir. Değişiklik içermeyen yama yazma yapmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding" ], "raw": "{{baseUrl}}/branding" } } }, { "name": "GET /v1/branding/applications/{application_id}", "request": { "description": "Bir uygulamanın tema taslağını döndürür (ortam temasının üstüne uygulanan geçersiz kılmalar). Uygulama bu ortamda\nyoksa `404`. Taslak yoksa boş tema ve `ETag: \"0\"`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding", "applications", ":application_id" ], "raw": "{{baseUrl}}/branding/applications/:application_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "PUT /v1/branding/applications/{application_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bir uygulamanın tema taslağını tümüyle değiştirir (verilmeyen jeton temizlenir; boş `theme` hepsini temizler).\n`If-Match` zorunludur (taslak yoksa `\"0\"`). Uygulama bu ortamda yoksa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding", "applications", ":application_id" ], "raw": "{{baseUrl}}/branding/applications/:application_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "POST /v1/branding/assets", "request": { "body": { "mode": "raw", "raw": "" }, "description": "Logo, favicon ya da arka plan görseli yükler. Gövde `multipart/form-data`: `kind`\n(`logo` | `favicon` | `background_image`) ve `file` (en çok 1 MiB). Kabul edilen biçimler PNG, JPEG, WebP ve\nyalnız favicon için ICO'dur; SVG ve başka biçimler `415 unsupported_media_type` döner. Yazı tipi yükleme GA'da\nkapalıdır (`kind=font` → `422`, `/kind font_upload_disabled`). Görsel yalıtılmış bir işçide çözülür, en çok\n1024×1024 PNG'ye yeniden kodlanır ve meta verisi atılır; favicon için 32 ve 180 px türevler de üretilir.\nKimlik, işlenmiş PNG'nin SHA-256'sıdır ve tema alanlarına (`logo`, `favicon`, `background_image`) yazılır.\nAynı tür ve içerik daha önce yüklenmişse var olan kayıt `200` ile döner. Ortam başına en çok 200 dosya ve\n50 MB; aşımda `403 quota_exceeded`. Idempotency anahtarıyla yinelenen istek aynı baytları (çok parçalı\nsınırlayıcı dahil) göndermelidir; farklı gövde `422 idempotency_key_reuse` alır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "multipart/form-data" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding", "assets" ], "raw": "{{baseUrl}}/branding/assets" } } }, { "name": "PUT /v1/branding/css", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortam taslağının özel CSS'ini değiştirir (Startup ve üstü; plan içermiyorsa `403 plan_feature_unavailable`,\n`feature: branding_custom_css`). Boş dize CSS'i temizler ve plan kapısı aramaz. En çok 50 KB, geçerli UTF-8. CSS\nbeyaz liste arındırıcısından geçer: yalnız `ui_catalog` sınıfları, izinli özellikler ve korumalı\nkatman kuralları; hepsi ya da hiç. İhlal varsa hiçbir şey yazılmaz ve `422 branding_validation_failed` bütün\nihlalleri `violations[]` uzantısında (satır, sütun, kural kodu, ad; CSS değeri yok) döner; 100 ihlalden sonra\narındırıcı durur ve son öğe `too_many_issues` kuralıdır. Kanonik çıktı kapsam öneki yüzünden girdiden uzundur; 51200\nbaytı aşarsa tek ihlal `too_large` kuralıdır (satır 1, sütun 1). Taslağa\ngirdinin kendisi değil arındırıcının kanonik çıktısı yazılır; yanıttaki `css` bu çıktıdır. `If-Match` ortam\ntaslağının sürümüdür (`GET /v1/branding`). Yanıt ortam taslağıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding", "css" ], "raw": "{{baseUrl}}/branding/css" } } }, { "name": "GET /v1/branding/organizations/{org_id}", "request": { "description": "Bir organizasyonun tema taslağını döndürür. Organizasyon düzeyi yalnız `logo` ve `light/dark.color.primary`\njetonlarını taşır ve yalnız doğrulanmış organizasyon bağlamında uygulanır. Taslak yoksa boş tema ve `ETag: \"0\"`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding", "organizations", ":org_id" ], "raw": "{{baseUrl}}/branding/organizations/:org_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "PUT /v1/branding/organizations/{org_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bir organizasyonun tema taslağını tümüyle değiştirir; `logo`, `light.color.primary` ve `dark.color.primary` dışındaki\njeton `422 validation_failed` (kod `token_not_allowed_in_scope`) döner. `If-Match` zorunludur (taslak yoksa `\"0\"`).\nOrganizasyonun varlığı bu sürümde denetlenmez (organizasyon deposu sonraki dilimdedir).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding", "organizations", ":org_id" ], "raw": "{{baseUrl}}/branding/organizations/:org_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "PUT /v1/branding/page-template", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortam taslağının Liquid sayfa şablonunu değiştirir (Startup ve üstü; plan içermiyorsa `403 plan_feature_unavailable`,\n`feature: branding_page_template`). Şablon yazmada sandbox'ta derlenir: yasak etiket, öznitelik, değişken ya da eksik\n`{{ idp.widget }}` yuvası `422 template_forbidden_construct` döner. Boş dize şablonu temizler. En çok 100 KB.\n`If-Match` ortam taslağının sürümüdür. Yanıt ortam taslağıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding", "page-template" ], "raw": "{{baseUrl}}/branding/page-template" } } }, { "name": "GET /v1/branding/texts/{screen}/{locale}", "request": { "description": "Bir (kapsam, ekran, dil) altındaki metin geçersiz kılmalarını döndürür; kapsam `application_id` ya da `org_id`\nsorgu parametresiyle seçilir (ikisi de yoksa ortam). Geçersiz kılınmayan anahtar platform kataloğundan gelir ve burada\ngörünmez. Ekran ve anahtar adı `^[a-z0-9][a-z0-9._-]{0,63}$`; dil kayıtlı BCP 47 kodudur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding", "texts", ":screen", ":locale" ], "query": [ { "description": "Uygulama kapsamı (önekli dış kimlik `app_…`); `org_id` ile birlikte verilemez. İkisi de yoksa kapsam ortamdır.", "disabled": true, "key": "application_id", "value": "" }, { "description": "Organizasyon kapsamı (önekli dış kimlik `org_…`); `application_id` ile birlikte verilemez.", "disabled": true, "key": "org_id", "value": "" } ], "raw": "{{baseUrl}}/branding/texts/:screen/:locale", "variable": [ { "description": "Yol anahtarı.", "key": "screen", "value": "" }, { "description": "Yol anahtarı.", "key": "locale", "value": "" } ] } } }, { "name": "PUT /v1/branding/texts/{screen}/{locale}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Anahtar → değer haritasını yazar (var olanı değiştirir, verilmeyen anahtara dokunmaz); biri geçmezse hiçbiri yazılmaz.\nAnahtar platform kataloğunda olmalı (`unknown_text_key`); değer 1–1000 karakter düz metin, denetim ve bidi geçersiz kılma\nkarakteri yok, `{{ ad }}` yer tutucu kümesi varsayılan metinle aynı (`placeholder_mismatch`). Korumalı katman metinleri\n(consent, cihaz onayı, çıkış onayı) geçersiz kılınamaz. Metinler sürümsüzdür (`If-Match` yok); yayımlanana dek görünmez.\nYanıt yazmadan sonraki (kapsam, ekran, dil) metinleridir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding", "texts", ":screen", ":locale" ], "query": [ { "description": "Uygulama kapsamı (önekli dış kimlik `app_…`); `org_id` ile birlikte verilemez. İkisi de yoksa kapsam ortamdır.", "disabled": true, "key": "application_id", "value": "" }, { "description": "Organizasyon kapsamı (önekli dış kimlik `org_…`); `application_id` ile birlikte verilemez.", "disabled": true, "key": "org_id", "value": "" } ], "raw": "{{baseUrl}}/branding/texts/:screen/:locale", "variable": [ { "description": "Yol anahtarı.", "key": "screen", "value": "" }, { "description": "Yol anahtarı.", "key": "locale", "value": "" } ] } } }, { "name": "DELETE /v1/branding/texts/{screen}/{locale}", "request": { "description": "Bir (kapsam, ekran, dil) altındaki geçersiz kılmaları siler; `key` verilmezse hepsini. Silinen anahtar platform\nvarsayılanına döner (yayımlanınca). Olmayan anahtarı silmek hata değildir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding", "texts", ":screen", ":locale" ], "query": [ { "description": "Uygulama kapsamı (önekli dış kimlik `app_…`); `org_id` ile birlikte verilemez. İkisi de yoksa kapsam ortamdır.", "disabled": true, "key": "application_id", "value": "" }, { "description": "Organizasyon kapsamı (önekli dış kimlik `org_…`); `application_id` ile birlikte verilemez.", "disabled": true, "key": "org_id", "value": "" }, { "description": "Silinecek metin anahtarı; tekrarlanabilir (en çok 500). Verilmezse (kapsam, ekran, dil) altındaki bütün geçersiz kılmalar silinir.", "disabled": true, "key": "key", "value": "" } ], "raw": "{{baseUrl}}/branding/texts/:screen/:locale", "variable": [ { "description": "Yol anahtarı.", "key": "screen", "value": "" }, { "description": "Yol anahtarı.", "key": "locale", "value": "" } ] } } }, { "name": "GET /v1/branding/versions", "request": { "description": "Yayınları yeniden eskiye listeler (ortam başına son 50 saklanır). Sayfalama yalnız ileri yöndedir (`after`);\n`before` ve `order` desteklenmez (`422`). Sürüm üst verisi anlık görüntü içeriği taşımaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding", "versions" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/branding/versions" } } }, { "name": "POST /v1/branding:preview-link", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Markalama taslaklarının barındırılan giriş sayfasındaki görünümü için 10 dakika geçerli bir önizleme bağlantısı\nüretir. Bağlantı ortamın GÜNCEL taslaklarını çizer (yayın beklenmez; taslak değişince sayfa\nyenisini gösterir); isteğe bağlı `application_id` ve `org_id` o düzeylerin taslağını da kalıtıma katar. Sayfada\nplatform önizleme bandı vardır ve giriş kapalıdır. `url` (`https:///u/preview?token=…`) yalnız\nbu yanıtta bir kez döner ve `Cache-Control: no-store` taşır; `Idempotency-Key` ile tekrar oynatılan yanıtta `url`\nyoktur ve `secret_redacted: true` döner. Ortamda aynı anda en çok 20 geçerli bağlantı olur; aşılırsa\n`429 rate_limited`. Uygulama bu ortamda yoksa `404`. Bağlantı geri çağrılamaz; süresi dolunca `404` verir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding:preview-link" ], "raw": "{{baseUrl}}/branding:preview-link" } } }, { "name": "POST /v1/branding:publish", "request": { "description": "Ortamın bütün markalama taslaklarını (ortam, uygulama ve organizasyon temaları, metinler, CSS, şablon) tek anlık\ngörüntü olarak yayımlar ve yeni sürüm numarası verir; yayınlar ortam başına seridir. Gövde yoktur. Yayın kapısı çözülmüş\ntemanın eksiksizliğini ve WCAG kontrastını iki varyantta denetler; geçmezse hiçbir şey yayımlanmaz ve\n`422 branding_validation_failed` bütün sorunları `issues[]` uzantısında (en çok 100; kapsam, jeton, kontrast çifti, oran,\neşik ve önerilen ton) döner. Taslaktaki özel CSS yayında yeniden arındırılır; geçmezse aynı kod ihlalleri\n`violations[]` uzantısında döner (`PUT /v1/branding/css`). Özel CSS'li taslak yayından önce barındırılan\nekranlarda çizilerek denetlenir: korumalı\nöğeyi bozan ya da yeni erişilebilirlik ihlali getiren CSS aynı `422 branding_validation_failed` ile\n`render_violations[]` uzantısında (ekran, dil, genişlik, kural, hedef; en çok 100, fazlası varsa\n`render_violations_truncated: true`) döner. Taslak denetim sırasında değişirse hiçbir şey yayımlanmaz ve\n`409 conflict` döner (yeniden yayımlayın); denetim kullanılamıyorsa `503 service_unavailable` (`Retry-After`).\nTaslakta özel CSS ya da şablon varken plan içermiyorsa `403 plan_feature_unavailable`.\nTaslaklar yayından sonra değişmez. Her yayın yönetim audit'ine ve `branding_published` olayına yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding:publish" ], "raw": "{{baseUrl}}/branding:publish" } } }, { "name": "POST /v1/branding:rollback", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Seçilen sürümün anlık görüntüsünü yeni sürüm olarak yeniden yayımlar (`source: rollback`); geçmiş yeniden yazılmaz ve\ntaslaklara dokunulmaz. Sürüm yoksa (son 50 yayın saklanır) `404`. O sürüm özel CSS ya da şablon taşıyor ve plan artık\niçermiyorsa `403 plan_feature_unavailable`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "branding:rollback" ], "raw": "{{baseUrl}}/branding:rollback" } } } ], "name": "branding" }, { "description": "`/v1/config-export` kaynak ailesi.", "item": [ { "name": "GET /v1/config-export", "request": { "description": "Ortamın yapılandırma kaynaklarını tek, ortamdan bağımsız bir belge olarak döndürür: kök\n`apiVersion: config.keenauth.com/v1`, her kaynak `kind`, `key` ve `spec` taşır. Belgede ortama özgü kimlik, sürüm,\nzaman damgası ve gizli değer bulunmaz; kaynaklar arası başvurular `key` iledir. Aynı yapılandırma bayt bayt aynı\nbelgeyi üretir (tür sırası, sonra `key`). Bu sürümde türler: `environment_settings`, `identity_settings`,\n`attack_protection`, `branding`, `connection`, `api`, `role`, `application`, `application_branding`. `attack_protection`\nmüşterinin yazdığı saldırı koruması alanlarını taşır; `role` ortam rollerini taşır; yazılmamış alan `null`'dır. Müşterinin emanet ettiği gizli alanlar\n(bağlantı `client_secret`) değer yerine `secret_ref` yer tutucusu taşır. Belgenin JSON\nSchema'sı `https://docs.keenauth.com/config/schema/v1.json`'dur. `config:read` iznine ek olarak\nbelgeye giren her tür kendi okuma iznini ister\n(eksikse `403 insufficient_permissions`, `required_permissions` tam listeyi verir). Belge 5.000 kaynağı ya da\n10 MiB'ı aşarsa `413 config_document_too_large`; `kinds` ile bölün. Yanıt JSON'dur (YAML 1.2'nin alt kümesi); CLI\nvarsayılan olarak YAML yazar.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "config-export" ], "query": [ { "description": "Belgeye girecek türler, virgülle ayrılmış (`environment_settings`, `identity_settings`, `attack_protection`, `branding`, `connection`, `api`, `role`, `application`, `application_branding`); yoksa bütün türler. Bilinmeyen tür, boş öğe ya da tekrarlanan parametre `422 validation_failed`.", "disabled": true, "key": "kinds", "value": "" } ], "raw": "{{baseUrl}}/config-export" } } } ], "name": "config-export" }, { "description": "`/v1/config-plans` kaynak ailesi.", "item": [ { "name": "POST /v1/config-plans", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bir yapılandırma belgesini hedef ortamın güncel durumuyla karşılaştırır ve planı saklar;\nhiçbir kaynağı değiştirmez. Gövde `{\"document\": , \"prune\": false}`'dur: belge `GET /v1/config-export`'un\nbiçimindedir ve `https://docs.keenauth.com/config/schema/v1.json` JSON Schema'sına uymalıdır (aksi\n`422 validation_failed`, `errors[].pointer` hatalı alanın `/document/...` işaretçisi). Belge gizli değer taşıyamaz:\ngizli alan yalnız `secret_ref` yer tutucusu ya da `null`'dur (değer `422`, `secret_value`; değer yanıtta yankılanmaz).\nHedef aynı motorla okunur ve kaynak başına `create`, `update`, `delete` ya da `no_op` ile RFC 6901 alan farkları\nüretilir; dışa aktarılan bir belge değiştirilmeden verilirse her kaynak `no_op`'tur. Belgenin kapsadığı türler\n`kinds` (verilmezse kaynakların türleri); belgede olmayan kaynak varsayılan olarak SİLİNMEZ, yalnız `prune: true`\nile ve yalnız kapsamdaki türlerde `delete` olur (tekil ayar türleri hiç silinmez). Son durumda çözülemeyen bir `key`\nbaşvurusu (`unresolved_reference`), budamanın sildiği bir kaynağa kalan başvuru (`/prune`, `still_referenced`) ve\norganizasyona ait ya da dinamik kayıtlı uygulamanın `key`'i ve sistem API'sinin `key`'i (`key_in_use`) ile\n`urn:idp:` ile başlayan API tanımlayıcısı (`/spec/identifier`, `reserved`) `422` döner. Serbest biçimli alanlar\ndirectory sınırlarını taşır: bağlantı `settings` 32 KiB ve 8 düzey (`too_long`, `too_deep`), uygulama `jwks` ve\nizin onay metni 16 KiB (`too_long`); dizi ve metin sınırları şemadadır. Tek bir kaynak ya da üst düzey alan\n200.000 JSON değerini aşarsa `422` `too_large`. Müşteri sırrı isteyen yeni\nbir bağlantı `requires_secret: true` ve `secret_required` uyarısı taşır; plan sırrın değerini taşımaz. Plan 1 saat\ngeçerlidir (`expires_at`), hedefin kaynak başına `object_version`'ını saklar ve süresi dolduktan 7 gün sonra silinir. `config:read`\niznine ek olarak belgedeki her tür (`prune` ile silinebilecek kaynaklara başvurabilen türler dahil) kendi okuma\niznini ister (eksikse `403`, `required_permissions` tam liste). Belge 5.000 kaynağı ya da 10 MiB'ı aşarsa\n`413 config_document_too_large`. Yanıt `Location: /v1/config-plans/{plan_id}` ve `Cache-Control: no-store` taşır.\nHer plan bir `config_plan.created` yönetim audit kaydı yazar. Sınırlar: işlem kendi `config_plan`\nhız ailesindedir (dakikada Free 20, Startup ve Business 60, Enterprise 120; üretim dışı ortamda onda biri); ortam\nbaşına en çok 100 uygulanmamış canlı plan ve saklama penceresinde 2.000 plan ya da 1 GiB tutulur (aşımda\n`429 rate_limited`, `Retry-After` kotanın açılacağı an); eşzamanlı plan hesapları bellek bütçesiyle sınırlıdır:\nortamın payı doluysa `429 rate_limited`, sürecin bütçesi doluysa `503 service_unavailable`, ikisinde de\n`Retry-After: 5`. İzin denetimi şema doğrulamasından önce yapılır. Belgede bilinmeyen zarf üyesi (`422`\n`/document` `invalid`), istekte bilinmeyen üye (`400 unknown_field`) ve sınırı aşan değer sayısı (`too_large`)\ngövde çözülmeden reddedilir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "config-plans" ], "raw": "{{baseUrl}}/config-plans" } } }, { "name": "GET /v1/config-plans/{plan_id}", "request": { "description": "Saklanan planı döndürür. Plan gizli değer taşımaz. Süresi (1 saat) dolmuş ve uygulanmamış\nplan `status: expired` döner; süresi dolduktan 7 gün sonra silinir (sonra `404`). Plan yoksa ya da başka bir\nortama aitse `404`. Planı okumak, oluşturmanın istediği okuma izinlerinin aynısını ister.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "config-plans", ":plan_id" ], "raw": "{{baseUrl}}/config-plans/:plan_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "plan_id", "value": "" } ] } } }, { "name": "POST /v1/config-plans/{plan_id}:apply", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Saklanan planı uygular. Gövde isteğe bağlıdır: `resolved_secrets` (planın\n`requires_secret` değişikliklerinin `secret_ref` adı → değer) ve `confirm_deletions` (`/`). Sır değeri\nhiçbir yanıtta, logda ya da kayıtta yer almaz; eksik ad `422` (`/resolved_secrets/`, `secret_missing`),\nplanda olmayan ad `secret_unused`, boş ya da 8 KiB'tan uzun değer `secret_invalid`. Kurumsal OIDC bağlantısının\nmalzemesi (`spec.oidc`) ve istemci sırrı federation'a, bağlantı kaydından sonra yazılır: malzeme yeni\noluşuyorsa `sp_host` zorunludur (`422 /sp_host sp_host_required`; gerekmiyorsa `sp_host_unused`), federation reddi\n`/changes//spec/oidc/...` işaretçisiyle `422` olur ve plan `planned` kalır; bağlantı kaydı yazılmış olabilir, yeni plan\nyalnız eksik malzemeyi yazar. Sosyal bağlantının sırrı için yazma ucu henüz olmadığından o sırrı isteyen plan\ndoğrulamadan sonra `501 not_implemented` döner. `config:write`,\nplanın okuma izinleri ve değişen her türün yazma izni (`environment-settings:write`, `identity-settings:write`,\n`attack-protection:write`, `branding:write`, `connections:write`, `apis:write`, `applications:write`) gerekir (eksikse `403`,\n`required_permissions` tam liste). Süresi (1 saat) dolmuş plan `410 config_plan_expired`; uygulanmış ya da\nçakışmış plan `409 config_plan_not_applicable` (`plan_status` uzantısı; aynı plan başka bir istekte uygulanırken `applying`). Hedef plan anından sonra değiştiyse (kaynak\nsürümü ya da kapsamın özeti; `prune` ile başvuran türler dahil) ya da kaynaklar arası başvurular artık tutmuyorsa\nhiçbir değişiklik yapılmaz, plan `conflicted` olur ve `409 config_conflict` döner. Desene uymayan\n`resolved_secrets` adı ve `confirm_deletions` öğesi `422` (`invalid`) alır.\nSon 30 günde token almış bir uygulamanın ve her bağlantının silinmesi `confirm_deletions`'ta tekrar edilmezse `409\ndeletion_not_confirmed` (`unconfirmed_deletions` uzantısı; plan `planned` kalır). Bütün yazmalar tek veritabanı\nişleminde yapılır: biri başarısız olursa hiçbiri kalmaz (alan hatası `/changes//spec/...` işaretçisiyle `422`;\nbaşka bir kaynağın tekil değeri `409 conflict` + `/changes//spec/` `duplicate`; kullanımdaki bağlantı `409\nconnection_in_use`; başarılı test girişi olmadan kurumsal bağlantıyı `active` oluşturan ya da etkinleştiren değişiklik\n`409 connection_test_required` + `/changes//spec` `test_required`; politika çatışması `422 policy_conflict`; bu\ndurumlarda plan `planned` kalır). Revizyon\ngörüntüsü 10 MiB'ı aşarsa directory'ye yazılmadan `413 config_document_too_large` döner.\nBaşarıda plan `applied` (`applied_at`) döner; etkilenen kaynakların uygulama öncesi görüntüsü revizyon olarak\nsaklanır ve tek bir `config.applied` yönetim audit kaydı (yalnız sayılar) yazılır; kaynak başına kayıtlar ayrıca\nüretilir. Yanıt `Cache-Control: no-store` taşır. Sınırlar (Ek 5 madde 14): işlem plan oluşturmayla aynı\n`config_plan` hız ailesini paylaşır ve plan hesabıyla aynı bellek bütçesinden geçer (ortam payı doluysa `429\nrate_limited`, süreç bütçesi doluysa `503 service_unavailable`, ikisinde de `Retry-After: 5`; plan `planned` kalır).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "config-plans", "{{plan_id}}:apply" ], "raw": "{{baseUrl}}/config-plans/{{plan_id}}:apply" } } } ], "name": "config-plans" }, { "description": "`/v1/config-revisions` kaynak ailesi.", "item": [ { "name": "GET /v1/config-revisions", "request": { "description": "Ortamın yapılandırma revizyonlarını döndürür: her başarılı `:apply`\netkilediği kaynakların uygulama öncesi görüntüsünü bir revizyon olarak saklar (ortam başına en yeni 50, en çok\n90 gün). Varsayılan sıra en yeni öncedir; sayfalama imleçlidir. Öğe yalnız başı taşır (kimlik, plan, aktör,\nzaman, türler, uygulamanın sayıları); görüntünün spec'leri ve sır değeri dönmez. Plan 7 gün sonra silinince\n`plan_id` null olur. Yalnız çağıranın ortamının revizyonları görünür. Yanıt `Cache-Control: no-store` taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "config-revisions" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/config-revisions" } } }, { "name": "POST /v1/config-revisions/{revision_id}:restore", "request": { "description": "Revizyondan geri alma planı üretir; hiçbir kaynağı değiştirmez. Geri alma doğrudan\nyazmaz: revizyonun görüntüsünden istenen belge kurulur ve `createConfigPlan`'ın aynı yolundan (şema doğrulaması,\nsır taraması, fark, başvuru denetimi, silme uyarıları, plan kotası, `config_plan.created` audit kaydı; metadata\n`source: revision_restore` ve `revision_id`) yeni bir plan saklanır. Plan `POST /v1/config-plans/{plan_id}:apply`\nile uygulanır; bayatlık (`409 config_conflict`), silme onayı ve sır kuralları orada geçerlidir. Belge: uygulamanın\ngüncellediği ve sildiği kaynaklar uygulama öncesi spec'leriyle (silinenler yeniden oluşturulur); uygulamanın\noluşturduğu kaynaklar silinir (plan o zaman `prune: true` olur ve kapsamdaki diğer kaynaklar `no_op` görünür).\nRevizyon sır değeri taşımaz: yeniden oluşturulan sır isteyen bağlantı `requires_secret` olur. Gövde yoktur\n(boş gövde, `{}` ya da `null` kabul edilir; başka üye `400 unknown_field`). `config:write` ve kapsamın okuma\nizinleri gerekir (`prune` iken başvuran türler dahil; eksikse `403`, `required_permissions` tam liste). Revizyon\nyoksa, başka bir ortama aitse ya da saklama süresi (90 gün) dolduysa `404`. Görüntü artık şemaya uymuyorsa ya da\nbaşvuruları bugünkü hedefte çözülmüyorsa `422` (işaretçi `/revision///...`; hâlâ başvurulan\noluşturulmuş kaynak `/revision/created` `still_referenced`; bilinmeyen tür `/revision_id` `not_restorable`).\nSınırlar `createConfigPlan` ile aynıdır (`config_plan` hız ailesi, bellek bütçesi `429`/`503` + `Retry-After`,\nplan kotası `429`, 10 MiB `413 config_document_too_large`). Yanıt `Cache-Control: no-store` taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "config-revisions", "{{revision_id}}:restore" ], "raw": "{{baseUrl}}/config-revisions/{{revision_id}}:restore" } } } ], "name": "config-revisions" }, { "description": "`/v1/connections` kaynak ailesi.", "item": [ { "name": "GET /v1/connections", "request": { "description": "Ortamdaki bağlantıları imleçli sayfalarla listeler. Ortam yalnız kimlik bilgisinden gelir. `type` ve `status`\nile süzülebilir; başka bir süzgeçle üretilmiş imleç `400 invalid_cursor` verir. Sıralama `created_at` + `id` ile kararlıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" }, { "description": "Bağlantı türüne göre süz (ör. `social`, `enterprise`). Değerler küçük harf, rakam ve alt çizgidir; bilinmeyen değer boş sonuç verir.", "disabled": true, "key": "type", "value": "" }, { "description": "Duruma göre süz: `active` ya da `inactive`.", "disabled": true, "key": "status", "value": "" } ], "raw": "{{baseUrl}}/connections" } } }, { "name": "POST /v1/connections", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Yeni bağlantı kaydeder. `key`, `type`, `strategy` ve `name` zorunludur; `key`, `type` ve `strategy` sonradan değişmez.\n`status` verilmezse `database`, `passwordless` ve `passkey` için `active`; protokol yapılandırması gereken `social` ve\n`enterprise` için `inactive` olur (etkinleştirme açık eylemdir: `:activate`). Kurumsal bağlantı `status: active` ile\noluşturulamaz: yeni bağlantının başarılı test girişi olamaz (KG-03), istek `409 connection_test_required` ile reddedilir\nve hiçbir şey yazılmaz. `settings` sır içeremez (sır benzeri anahtar\nadı ya da değer `422` ile reddedilir); protokol sırları ayrı bir yüzeydedir. Ortam başına en çok 100 bağlantı, en çok 20 genel\nsosyal (`oidc_generic`, `oauth2_generic`) bağlantı ve org başına en çok 20 bağlantı olabilir (`403 quota_exceeded`). Yanıt `ETag` başlığı taşır.\n`type = passkey` bağlantısında `settings` kapalı bir anahtar kümesidir (`PasskeyConnectionSettings`): bilinmeyen anahtar,\nyanlış tür ya da aralık dışı değer `422 validation_failed` döndürür (`errors[].pointer` = `/settings/`); dolu\n`rp_id` ortamın `active` özel alanının host adı olmalıdır. Plana bağlı alanlar varsayılandan farklı yazılırsa `403 plan_feature_unavailable` (`feature`,\n`required_plan` uzantılarıyla) döner; `related_origins` için hak varsa her köken ortamın doğrulanmış özel alanı olmalıdır\n(`422 related_origin_not_verified`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections" ], "raw": "{{baseUrl}}/connections" } } }, { "name": "GET /v1/connections/{connection_id}", "request": { "description": "Bağlantıyı döndürür. Başka ortamın ya da var olmayan bağlantı `404 not_found` verir (varlık sızdırılmaz). Yanıt `ETag`\nbaşlığı taşır (`PATCH` ve `DELETE` için `If-Match`). Kurumsal bağlantıda `pending_revision_id` bekleyen taslak\nrevizyonun kimliğidir; alan yalnız bu uçta ve kurumsal yapılandırma servisi okunabildiğinde\nvardır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id" ], "raw": "{{baseUrl}}/connections/:connection_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "DELETE /v1/connections/{connection_id}", "request": { "description": "Bağlantıyı siler (kullanıcı verisini silmez). `If-Match` zorunludur. Etkin bağlantıya bağlı kimliği olan kullanıcı\nvarsa `409 connection_in_use` döner; önce `:deactivate` gerekir. Silinen bağlantı uygulama bağlantı listelerinden de düşer.\nSilinen bağlantı 30 gün içinde `POST /v1/connections/{connection_id}:restore` ile `inactive` olarak geri yüklenebilir;\nsonra kalıcı silinir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id" ], "raw": "{{baseUrl}}/connections/:connection_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "PATCH /v1/connections/{connection_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bağlantıyı RFC 7396 birleştirme yamasıyla günceller (`application/merge-patch+json`). `If-Match` zorunludur (yoksa\n`428`, eşleşmezse `412`). `null` ata `display_name` ve `settings` alanlarını temizler; `key`, `type` ve `strategy`\ndeğiştirilemez (`422`, kod `immutable`). Durum değişimi (`status`) `:activate` / `:deactivate` ile aynı sonucu verir;\nkurumsal bağlantıyı `active` yapan yama ve etkin kurumsal bağlantının `allowed_email_domains`'ine alan ekleyen yama da test\nkapısından geçer (`409 connection_test_required`, denetim yapılamazsa `503`; hiçbir şey yazılmaz); alan çıkarmak denetlenmez.\nDeğişiklik içermeyen yama yazma yapmaz ve sürümü artırmaz. `settings` sır içeremez. `type = passkey` için `settings`\nbirleşim sonucu `PasskeyConnectionSettings` kurallarıyla doğrulanır: `422 validation_failed` (şekil), plana bağlı alanlar\niçin `403 plan_feature_unavailable` (`feature`, `required_plan`) ve `422 related_origin_not_verified`; şekil hatası\nplan kapısından önce döner. `settings.rp_id` ortamın `active` özel alanının host adı ya da boş olmalıdır (değilse\n`422 validation_failed`, `/settings/rp_id`); değeri değiştiren yama bu ortamda passkey varken `409\nrp_id_change_requires_migration` alır, passkey sayımı alınamazsa `503\nservice_unavailable` (`Retry-After`); iki durumda da hiçbir şey yazılmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id" ], "raw": "{{baseUrl}}/connections/:connection_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "GET /v1/connections/{connection_id}/attribute-mappings", "request": { "description": "Kurumsal bağlantının öznitelik eşleme listesini hedefe göre sıralı döndürür; yanıt `ETag` taşır (kanonik\nlistenin SHA-256 özeti; `PUT` ve `:apply-profile` için `If-Match`). Kayıtlı satırı olmayan bağlantıda liste boştur:\ngirişte şablon varsayılanı uygulanır (OIDC'de `generic` hazır profili, SAML'de eşleme yok). Kurumsal olmayan\n(database, social, passkey…) ya da bu ortamda olmayan bağlantı `404`'tür. Okuma audit'e yazılmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "attribute-mappings" ], "raw": "{{baseUrl}}/connections/:connection_id/attribute-mappings", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "PUT /v1/connections/{connection_id}/attribute-mappings", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bağlantının öznitelik eşleme listesini tam olarak değiştirir.\n`If-Match` zorunludur: yoksa `428`, son okunan `ETag` ile eşleşmezse ya da liste arada değiştiyse `412` ve hiçbir\nşey yazılmaz. Kurallar: yalnız bilinen hedefler (`email` zorunlu; `given_name`, `family_name`, `name`, `locale`,\n`zoneinfo`, `phone`, `groups`, `user_metadata.`; kayıtlı OIDC claim adları ve `idp_` öneki anahtar olamaz,\n`app_metadata` yazılamaz), hedef başına bir satır, en çok 20 `user_metadata` anahtarı ve toplam 28 satır, kaynak adı\n1–512 bayt (denetim/bidi karakteri ve baş/son boşluk yok), `source_name_format` mutlak URI ve bir kaynak adı için tek\nbiçim, `overwrite` `always`|`if_empty`|`never`, `profile` hazır profil kümesinden (verilmezse `generic`). Her kırık\nkural `422 validation_failed` içinde bir `errors[]` öğesidir (işaretçi `/attribute_mappings//` ya da\nliste kuralları için `/attribute_mappings`: `email_required`, `too_many_metadata_keys`). LDAP bağlantısı eşleme\ntaşımaz (`409 conflict`). Aynı liste yazma yapmaz (sürüm ve audit değişmez). Değişiklik bir sonraki girişten\nitibaren geçerlidir; son başarılı bağlantı testini geçersiz kılmaz. Yazma yönetim audit'ine\n`connection.attribute_mappings_replaced` olarak geçer (eklenen, silinen, değişen hedefler; öznitelik değeri yok).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "attribute-mappings" ], "raw": "{{baseUrl}}/connections/:connection_id/attribute-mappings", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "POST /v1/connections/{connection_id}/attribute-mappings:apply-profile", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Sabit hedef satırlarını (email, adlar, groups…) bir hazır profilin satırlarıyla değiştirir: SAML `entra`, `okta`, `google`, `ping`, `jumpcloud`, `keycloak`; OIDC `generic`. Kayıtlı `user_metadata.` satırları kalır.\nSAML özne özniteliği değişmez (özne ayrı ayarlanır; değiştirmek bağlı kimlikleri yetim bırakır). `If-Match`\nzorunludur (`PUT` ile aynı: yoksa `428`, eşleşmezse `412`). Bilinmeyen ya da bağlantının protokolüne ait olmayan\nprofil `422 validation_failed` (`/profile`); kalan bir `user_metadata` satırı profil kaynağını başka NameFormat'la\nokuyorsa `422 validation_failed` (`/profile`, `conflicts_with_stored_mappings`). LDAP bağlantısı `409 conflict`.\nProfil zaten uygulanmışsa yazma yapılmaz. Yazma `connection.attribute_mappings_replaced` audit'ine profil adıyla\ngeçer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "attribute-mappings:apply-profile" ], "raw": "{{baseUrl}}/connections/:connection_id/attribute-mappings:apply-profile", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "GET /v1/connections/{connection_id}/certificates", "request": { "description": "Kurumsal SAML bağlantısının etkin IdP imza sertifikalarını döndürür: kimlik (`conncert_…`), SHA-256\nparmak izi, geçerlilik aralığı ve kaynak (`metadata` ya da `manual`). Sertifikanın kendisi ve konusu (kişi adı ya da\ne-posta taşıyabilir) döndürülmez. Bağlantı başına en çok 3 etkin sertifika olduğundan liste sayfalanmaz: `limit`,\n`after`, `before`, `order` yoktur ve `list_metadata` imleç taşımaz. SAML yapılandırması henüz oluşturulmamış bağlantıda\nliste boştur; SAML olmayan bağlantı `409 conflict`, kurumsal olmayan ya da bu ortamda olmayan bağlantı `404`'tür. Okuma\naudit'e yazılmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "certificates" ], "raw": "{{baseUrl}}/connections/:connection_id/certificates", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "POST /v1/connections/{connection_id}/certificates", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kurumsal SAML bağlantısına bir IdP imza sertifikası ekler. PEM\nbiçiminde tek `CERTIFICATE` bloğu (en çok 8 KiB); süresi dolmamış, RSA ≥ 2048 bit ya da ECDSA P-256/P-384/P-521 anahtarlı\nolmalıdır (aksi `422 validation_failed`, `/certificate`; nedeni ve sertifikanın içeriği yanıtta ve logda yer almaz).\nRotasyon etkin bağlantıda da doğrudan uygulanır. Yeni sertifika `201`, bağlantıda zaten kayıtlı olan aynı\nsertifika `200` ile döner (yazma ve audit yok). Bağlantı başına en çok 3 etkin sertifika vardır (aşılırsa `409 conflict`);\ndaha önce silinmiş bir sertifika yeniden eklenemez (`409 conflict`). SAML olmayan ya da SAML yapılandırması henüz\noluşturulmamış bağlantı `409 conflict`. `If-Match` almaz. Yazma yönetim audit'ine `connection.idp_certificate_added`\nolarak geçer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "certificates" ], "raw": "{{baseUrl}}/connections/:connection_id/certificates", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "DELETE /v1/connections/{connection_id}/certificates/{certificate_id}", "request": { "description": "IdP imza sertifikasını bağlantıdan siler: sertifika\nemekliye ayrılır, o andan itibaren imza doğrulamada kullanılmaz, listede görünmez ve yeniden eklenemez. Zaten silinmiş\nsertifika da `204`'tür. Şu an geçerli son etkin sertifika silinemez (`409 conflict`): bağlantı her girişi reddederdi; önce\nyeni sertifikayı ekleyin. Bilinmeyen sertifika, biçimsiz kimlik, kurumsal olmayan ya da bu ortamda olmayan bağlantı\n`404`; SAML olmayan bağlantı `409 conflict`. `If-Match` almaz. Silme yönetim audit'ine `connection.idp_certificate_retired`\nolarak geçer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "certificates", ":certificate_id" ], "raw": "{{baseUrl}}/connections/:connection_id/certificates/:certificate_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "certificate_id", "value": "" } ] } } }, { "name": "PUT /v1/connections/{connection_id}/idp-initiated", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "SAML kurumsal bağlantının IdP-initiated (istenmemiş yanıt) girişine izin verir ya da izni kapatır ve hedef uygulamaları\nyazar. Tam değiştirmedir: üç alan her istekte yazılır; verilmeyen\n`idp_initiated_default_application_id` ve boş `idp_initiated_allowed_application_ids` temizlenir. Varsayılan kapalıdır;\naçarken RelayState boş geldiğinde kullanılacak varsayılan uygulama zorunludur. RelayState yalnız\n`idp_initiated_allowed_application_ids` listesindeki (ya da varsayılan) uygulamanın `client_id`'siyle bayt bayt\neşleşirse o uygulamayı seçer; URL olarak yorumlanmaz. Her hedef bu ortamda var olan, tarayıcı girişi olan (m2m,\nmanagement ya da CIMD olmayan) ve `initiate_login_uri` kayıtlı bir uygulama olmalıdır; liste tekil ve en çok 20\nöğedir. SAML olmayan bağlantı, eksik varsayılan ya da uygun olmayan hedef `422 validation_failed`'dır (`errors[]`\nişaretçisi alan adıdır). Ayar güvenliği gevşettiği için pano kullanıcısında adım yükseltme ister ve yalnız\n`owner`/`admin` yazabilir; Yönetici Portalı bu alanları yazamaz. `If-Match` verilirse bağlantının `ETag`'iyle\neşleşmelidir (`412`). Yanıt güncel bağlantı kaynağıdır. Yazma yönetim audit'ine `connection.updated` olarak geçer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "idp-initiated" ], "raw": "{{baseUrl}}/connections/:connection_id/idp-initiated", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "GET /v1/connections/{connection_id}/oidc", "request": { "description": "Kurumsal OIDC bağlantısının RP yapılandırmasını döndürür: IdP'ye verilecek `redirect_uri`, `issuer`,\n`client_id`, istemci kimlik doğrulama yöntemi ve sağlayıcı profili. Client sırrı hiçbir yanıtta yoktur; yalnız\n`client_secret_configured` ve (verildiyse) `client_secret_expires_at` döner. Yanıt `ETag` taşır (yazılabilen alanların\nSHA-256 özeti; `PUT` için `If-Match`). Yapılandırması henüz yazılmamış, OIDC olmayan, kurumsal olmayan ya da bu\nortamda olmayan bağlantı `404`'tür. Okuma audit'e yazılmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "oidc" ], "raw": "{{baseUrl}}/connections/:connection_id/oidc", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "PUT /v1/connections/{connection_id}/oidc", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kurumsal OIDC bağlantısının RP yapılandırmasını oluşturur ya da tam olarak değiştirir.\nİlk yazım `If-Match` almaz ve `sp_host` ister (ortamın etkin host'u; callback `https:///sso//callback`\nolarak dondurulur), yanıt `201`'dir; `If-Match` ile ilk yazım `412`'dir. Yapılandırma varken `If-Match` zorunludur: yoksa `428` ve hiçbir şey yazılmaz (başlıksız istek\nvar olan yapılandırmayı ezmez), son okunan `ETag` ile eşleşmezse ya da arada başka yazım olduysa `412`; `*` mevcut\nyapılandırmayla eşleşir. Güncellemede `sp_host` boş ya da kayıtlı host olmalıdır (başkası `409 conflict`).\n`client_secret` yalnız yazılır: hiçbir yanıtta, logda ya da audit kaydında değeri yoktur; güncellemede verilmezse\nkayıtlı sır korunur, `private_key_jwt` sırrı siler (istemci iddiasını ortamın RP anahtarı imzalar). Sır isteyen\nyöntemde ne kayıtlı ne verilen sır varsa `409 conflict`. Oluşturmada ve `issuer` değişiminde (taslak revizyon dahil)\n`/.well-known/openid-configuration` çıkış vekili üzerinden çekilir: belgedeki `issuer` girilenle bayt\nbayt aynı değilse `422 validation_failed` (`/issuer`), belge çekilemez ya da geçerli bir yapılandırma değilse\n`409 conflict`; ikisinde de hiçbir şey yazılmaz. Çekilen belge yazımla saklanır (eski issuer'ın belgesi silinir),\naynı `issuer` yeniden çekilmez. `issuer` ya da `client_id` değişirse son başarılı bağlantı testi geçersizleşir. Değer kuralları ihlali `422 validation_failed`\n(`errors[]` işaretçisi alan adıdır: `/issuer`, `/client_id`, `/client_auth_method`, `/client_secret`,\n`/provider_profile`, `/entra_tenant_id`, `/sp_host`). OIDC olmayan bağlantı `409 conflict`. Aynı yapılandırma yazma\nyapmaz. Yazma yönetim audit'ine `connection.protocol_config_created` ya da `connection.oidc_config_updated` (değişen\nalanlar; sır yalnız `client_secret_set`) olarak geçer. Etkin bağlantıda `issuer` ya da `client_id` değişiyorsa yazım\nuygulanmaz, bütünüyle (yeni sır dahil) taslak revizyon olur: yanıt `200`, canlı yapılandırmayı, canlı `ETag`'i\nve `revision`'ı taşır; taslak `:test` gövdesinde `revision_id` ile denenip `…:publish` ile yayımlanır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "oidc" ], "raw": "{{baseUrl}}/connections/:connection_id/oidc", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "GET /v1/connections/{connection_id}/revisions", "request": { "description": "Kurumsal bağlantının taslak revizyonlarını en yeniden eskiye listeler: bekleyen taslak (en\nçok bir) ve son 90 günde yayımlanmış ya da düşmüş revizyonlar. Etkin bağlantıda güvenlik-kritik değişiklik (IdP entityID\nya da SSO URL'si, metadata imza sabitlemesinin kalkması, OIDC `issuer` ya da `client_id`) ve her SP host taşıması\n(`:migrate-sp-host`) doğrudan uygulanmaz, taslak revizyon olur; taslak `:test` gövdesinde `revision_id` ile denenir ve\n`…/revisions/{revision_id}:publish` ile yayımlanır. Her revizyon yalnız sır olmayan değişikliklerini (`changes`; yeni\nclient sırrı yalnız `client_secret_change` olarak) ve son testini (`latest_test`, 24 saat) taşır; aktör yönetim\naudit'indedir. Sayfalama yalnız ileri yöndedir: `limit` (1–100) ve `after`; `before` ya da `order` verilirse `422\nvalidation_failed`. İmleç bağlantıya bağlıdır (başka bağlantının imleci `400 invalid_cursor`). Kurumsal olmayan ya da bu\nortamda olmayan bağlantı `404`'tür. Okuma audit'e yazılmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "revisions" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/connections/:connection_id/revisions", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "POST /v1/connections/{connection_id}/revisions/{revision_id}:publish", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bağlantının taslak revizyonunu canlı yapılandırma yapar. Yayım tek işlemde canlı malzemeyi\nrevizyonunkiyle değiştirir (SAML: IdP tarafı ve yeni sertifikalar; OIDC: RP malzemesi ve sırrı; SP host taşıma: SP\nhost'u ve SP URL'leri, eski host 30 gün daha yanıt verir), revizyonu `published` yapar ve yönetim audit'ine\n`connection.revision_published` yazar. Son 24 saatte bu revizyonla (`:test` gövdesinde `revision_id`) geçmiş bir test\ngirişi gerekir; yoksa `409 conflict`. Zaten yayımlanmış revizyon yazmadan `200` ve `already_published: true` döner\n(eşzamanlı iki yayımdan yalnız biri yazar). Düşmüş (`discarded`) revizyon, taslak yapıldıktan sonra canlı yapılandırması\ndeğişen bağlantı (yeni taslak gerekir), önceki SP host taşımasının 30 günlük penceresi sürerken SP host taslağı, ortamdan\nçıkmış yeni host, 3 etkin sertifika sınırı ve protokol yapılandırması olmayan bağlantı `409 conflict`'tir (`detail` hangi\nönkoşulun tutmadığını sabit bir cümleyle söyler). Bu bağlantının olmayan revizyonu, kurumsal olmayan ya da bu ortamda\nolmayan bağlantı `404`'tür. Gövde yoktur (boş gövde ya da `{}`). `If-Match` almaz: revizyonun sürümü yoktur, canlı\nyapılandırmanın taslaktan sonra değişmesi sunucuda denetlenir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "revisions", "{{revision_id}}:publish" ], "raw": "{{baseUrl}}/connections/:connection_id/revisions/{{revision_id}}:publish", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "GET /v1/connections/{connection_id}/role-mappings", "request": { "description": "Kurumsal bağlantının (SAML/OIDC) dış grup → rol eşlemelerini kimlik sırasıyla (eskiden yeniye) imleçli listeler; yalnız\nileri sayfalama vardır. İmleç bağlantıya bağlıdır. Bağlantı yoksa, kurumsal değilse ya da başka ortamdaysa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "role-mappings" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/connections/:connection_id/role-mappings", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "POST /v1/connections/{connection_id}/role-mappings", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "IdP'nin gönderdiği grup değerini (`external_group_key`, aynen) bir role (`rol_…`) eşler; federation girişte üyeliğe\n`idp_mapping` kaynaklı rol verir. Org bağlantısında rol ortam rolü ya da o org'un rolü olmalıdır. Ayrıcalıklı role eşleme\nek olarak `roles:write` ister ve onaylı oluşur. Aynı grup değeri\nbağlantıda zaten eşlenmişse `409 conflict`; bağlantı başına 500 eşleme (`409 role_mapping_limit_reached`). Yazma\n`role_mapping.created` audit'idir (grup değeri audit'e girmez).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "role-mappings" ], "raw": "{{baseUrl}}/connections/:connection_id/role-mappings", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "GET /v1/connections/{connection_id}/role-mappings/{mapping_id}", "request": { "description": "Eşlemeyi döndürür (`rmp_…`). `approved_at` null ise eşleme onaysızdır: rol ayrıcalıklıysa federation rolü vermez.\nEşleme yoksa ya da başka bağlantı veya ortamdaysa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "role-mappings", ":mapping_id" ], "raw": "{{baseUrl}}/connections/:connection_id/role-mappings/:mapping_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "mapping_id", "value": "" } ] } } }, { "name": "DELETE /v1/connections/{connection_id}/role-mappings/{mapping_id}", "request": { "description": "Eşlemeyi siler; yanıt gövdesizdir. Eşleme yoksa ya da başka bağlantı veya ortamdaysa `404`. Eşlemeyle verilmiş roller\nsonraki girişte yeniden hesaplanır. Silme `role_mapping.deleted` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "role-mappings", ":mapping_id" ], "raw": "{{baseUrl}}/connections/:connection_id/role-mappings/:mapping_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "mapping_id", "value": "" } ] } } }, { "name": "POST /v1/connections/{connection_id}/role-mappings/{mapping_id}:approve", "request": { "description": "Rolü eşlemeden sonra ayrıcalıklı yapılan eşlemeyi onaylar; onaydan sonra federation rolü yeniden verir.\n`connections:write` ile birlikte `roles:write` ister. Gövde yoktur. Ayrıcalıksız role eşleme onay gerektirmez (`409\nconflict`); onaylı eşlemede işlem etkisizdir. Yazma `role_mapping.approved` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "role-mappings", "{{mapping_id}}:approve" ], "raw": "{{baseUrl}}/connections/:connection_id/role-mappings/{{mapping_id}}:approve", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "GET /v1/connections/{connection_id}/rp-id-migration", "request": { "description": "Bağlantının en son rpId göçünü (süren ya da kapanmış) döndürür. Hiç göçü olmayan, passkey türünde\nolmayan ya da bu ortamda olmayan bağlantı `404 not_found`'dur. `revoked_count` ve `new_registration_count` göç\nkapanınca yazılır; süren göçte `null`'dır. Okuma audit'e yazılmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "rp-id-migration" ], "raw": "{{baseUrl}}/connections/:connection_id/rp-id-migration", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "GET /v1/connections/{connection_id}/sp-metadata", "request": { "description": "Kurumsal SAML bağlantısının imzalı SP metadata belgesini (SAML 2.0 `EntityDescriptor`) indirir:\nIdP yöneticisinin IdP'ye yüklediği belgedir. İçerik, bağlantının dondurulmuş SP host'undaki kamu adresinin\n(`https:///saml//metadata`) yayımladığıyla aynıdır: `entityID`, `validUntil` (7 gün), `cacheDuration`\n(`PT24H`), imza ve şifreleme sertifikaları (rotasyon penceresinde ikişer), NameID biçimleri, ACS (HTTP-POST) ve SLO\nuçları; belge bağlantının etkin SP imza anahtarıyla imzalıdır. SP anahtarları henüz yoksa ilk kullanımda oluşturulur. Yanıt, kamu adresiyle aynı medya türünde `application/samlmetadata+xml` gövdesidir,\n`Content-Disposition: attachment; filename=\"-sp-metadata.xml\"` ve `Cache-Control: no-store`\ntaşır. SAML olmayan bağlantı ya da SAML yapılandırması henüz oluşturulmamış bağlantı `409 conflict`, kurumsal olmayan\nya da bu ortamda olmayan bağlantı `404`'tür. Okuma audit'e yazılmaz. `revision_id` (`connrev_…`) verilirse bağlantının\ntaslak revizyonunun belgesi döner: SP host taşımasında yeni host'taki uçlarla, yayından önce IdP'ye yüklenecek belge. Biçimsiz ya da bu bağlantının taslağı olmayan `revision_id` `422 validation_failed` (`/revision_id`; kod\n`invalid_value` ya da `not_found`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "sp-metadata" ], "query": [ { "description": "Bağlantının taslak revizyonu (`connrev_…`); verilirse o taslağın SP metadata belgesi döner.", "disabled": true, "key": "revision_id", "value": "" } ], "raw": "{{baseUrl}}/connections/:connection_id/sp-metadata", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "GET /v1/connections/{connection_id}/subject-conflicts", "request": { "description": "Kurumsal bağlantının SSO özne çakışması kayıtlarını imleçli sayfalarla listeler. Kayıt, bu\nbağlantıya başka özneyle bağlı bir kullanıcının doğrulanmış adresi yeni bir özneyle geldiğinde açılır; giriş\nreddedilir ve hiçbir kimlik bağlanmaz. Aynı özne kayıt açıkken yeniden gelirse yeni kayıt açılmaz. Açık kayıt 30 gün\nsonra `expired` olur. Yanıt yalnız kimlikleri, durumu, kararı ve zamanları taşır; dış özne ve e-posta adresi\ndönmez. İzin `users:read`'dir (kayıt bir kullanıcı hesabına yöneliktir). Bu ortamda olmayan bağlantı\n`404 not_found`'dur. Sıralama `created_at` + `id` ile kararlıdır; imleç bağlantıya bağlıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "subject-conflicts" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/connections/:connection_id/subject-conflicts", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "POST /v1/connections/{connection_id}/subject-conflicts/{conflict_id}:resolve", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "SSO özne çakışması kaydına yöneticinin kararını uygular. `same_person`: yeni özne aynı kişidir\n(ör. IdP'de hesap yeniden oluşturuldu); kullanıcının bu bağlantıdaki eski kimliği yeni özneyle değiştirilir ve\nkullanıcı bir sonraki girişte yeni özneyle girer. Kullanıcı etkin değilse `403 user_not_active`; bağlantı etkin\ndeğilse, yeni özne başka bir kullanıcıya bağlandıysa ya da kimlik sınırı doluysa `409 conflict`; bu durumlarda\nkayıt açık kalır. `different_person`: adres yeni bir kişiye verildi; kayıt kapanır ve hiçbir kimlik bağlanmaz.\nYeni kişinin sonraki girişi yeni bir kayıt açar; bunu durdurmak için eski hesabın adresini değiştirin ya da\nhesabı engelleyin. Kimlik değişikliği, olaylar ve yönetim audit'i tek işlemde yazılır. Aynı kararın tekrarı kaydı\nyeniden yazmadan `200` döner; farklı karar `409 conflict`'tir. Süresi dolmuş, başka bağlantının ya da bu ortamda\nolmayan kayıt `404 not_found`'dur. Geçersiz `resolution` `422 validation_failed` (`/resolution`) döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "subject-conflicts", "{{conflict_id}}:resolve" ], "raw": "{{baseUrl}}/connections/:connection_id/subject-conflicts/{{conflict_id}}:resolve", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "GET /v1/connections/{connection_id}/test-results/latest", "request": { "description": "Bağlantının saklanan (son 24 saat) en yeni test girişinin sonucunu döndürür: durum (`pending`,\n`passed`, `failed`), başarısızlık nedeni, IdP'den gelen öznitelik **adları**, grup sayısı ve değer alan\neşlenmiş alanlar. Öznitelik değeri, ham assertion ya da ID token saklanmaz ve döndürülmez. Saklanan testi olmayan,\nkurumsal olmayan ya da bu ortamda olmayan bağlantı `404`'tür. Uç `connections:write` izni ister.\nOkuma audit'e yazılmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", ":connection_id", "test-results", "latest" ], "raw": "{{baseUrl}}/connections/:connection_id/test-results/latest", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connection_id", "value": "" } ] } } }, { "name": "POST /v1/connections/{connection_id}:activate", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bağlantıyı etkinleştirir (`status` = `active`). Gövde isteğe bağlıdır ve alan içermez (`{}`). İşlem eşgüçlüdür: bağlantı zaten bu durumdaysa\nyazma yapılmaz, sürüm artmaz ve mevcut kaynak 200 ile döner. `If-Match` almaz; başka bir yazarla yarışta bağlantı yeniden\nokunarak birkaç kez denenir (süren çakışma `412`). Kurumsal (`enterprise`) bağlantıda etkinleştirme, güncel protokol\nyapılandırmasının ve kalacak `allowed_email_domains`'in son 24 saatte başarılı bir test girişi olmasını ister; yoksa `409 connection_test_required` döner ve hiçbir şey yazılmaz. Denetim yapılamıyorsa (federation\nerişilemez) etkinleştirme yapılmaz, `503 service_unavailable` döner. Diğer bağlantı türlerinde bu denetim yoktur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", "{{connection_id}}:activate" ], "raw": "{{baseUrl}}/connections/{{connection_id}}:activate" } } }, { "name": "POST /v1/connections/{connection_id}:change-rp-id", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Passkey bağlantısının rpId'sini yeni değere geçirir ve göç penceresini başlatır.\nPasskey'i olan bir ortamda rpId'nin tek değişme yoludur (`PATCH` ile değişiklik `409 rp_id_change_requires_migration`).\n`If-Match` zorunludur ve bağlantının ETag'idir (yoksa `428`, eşleşmezse `412`). `new_rp_id` ortamın `active` özel\nalanının host adıdır (küçük harf A-label) ya da boş dizgedir (her giriş host'u kendi rpId'si); `confirm_rp_id` aynı\ndeğerin tekrar yazımıdır; `migration_window_days` 30–365, verilmezse 90. Pencere boyunca önceki rpId'deki passkey'lerle\ngiriş sürer ve yeni kayıtlar yeni rpId'dedir; pencere bitince ya da `:complete-rp-id-migration` ile erken kapatılınca\nönceki rpId'deki passkey'ler `rp_id_changed` nedeniyle iptal edilir. Bağlantının rpId'si, göç kaydı, yönetim audit'i\nve `passkey_rp_id.migration_started` olayı tek işlemde yazılır. Eksik, 253 bayttan uzun ya da aralık dışı alan,\nortamın active özel alanı olmayan ya da mevcut değerle aynı `new_rp_id`, eşleşmeyen `confirm_rp_id` ve passkey türünde\nolmayan bağlantı `422 validation_failed` (`errors[].pointer`: `/new_rp_id`, `/confirm_rp_id`,\n`/migration_window_days`, `/connection_id`); ortamda süren başka göç `409 rp_id_migration_in_progress`. Yanıt göç\nkaydıdır; `ETag` bağlantının yeni sürümüdür.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", "{{connection_id}}:change-rp-id" ], "raw": "{{baseUrl}}/connections/{{connection_id}}:change-rp-id" } } }, { "name": "POST /v1/connections/{connection_id}:complete-rp-id-migration", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bağlantının süren rpId göçünü pencere bitmeden kapatır: durum `completed_early`\nolur (bitiş anı geçmişse `completed`), önceki rpId'deki kalan passkey'ler `rp_id_changed` nedeniyle iptal edilir, önceki\nrpId'nin kökeni izinli kümeden çıkar ve `passkey_rp_id.migration_completed` olayı yayımlanır. Gövde boş ya da `{}`'dir.\nSüren göç yoksa (ikinci çağrı dahil) `409 no_active_rp_id_migration`; passkey sayımı alınamazsa `503\nservice_unavailable` (`Retry-After`) ve göç açık kalır. Bu ortamda olmayan bağlantı `404 not_found`'dur. Yanıt\nkapanmış göç kaydıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", "{{connection_id}}:complete-rp-id-migration" ], "raw": "{{baseUrl}}/connections/{{connection_id}}:complete-rp-id-migration" } } }, { "name": "POST /v1/connections/{connection_id}:deactivate", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bağlantıyı devre dışı bırakır (`status` = `inactive`). Gövde isteğe bağlıdır ve alan içermez (`{}`). İşlem eşgüçlüdür: bağlantı zaten bu durumdaysa\nyazma yapılmaz, sürüm artmaz ve mevcut kaynak 200 ile döner. `If-Match` almaz; başka bir yazarla yarışta bağlantı yeniden\nokunarak birkaç kez denenir (süren çakışma `412`). Protokol yapılandırmasının tamlığı bu işlemde denetlenmez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", "{{connection_id}}:deactivate" ], "raw": "{{baseUrl}}/connections/{{connection_id}}:deactivate" } } }, { "name": "POST /v1/connections/{connection_id}:import-metadata", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Yüklenen SAML 2.0 IdP metadata belgesini kurumsal SAML bağlantısına uygular. Belge güvenli\nayrıştırıcı sınırlarıyla işlenir; birden çok `EntityDescriptor` içeren belgede `entity_id`\nzorunludur, tek varlıkta verilirse eşleşmelidir. IdP tarafı (entityID, HTTP-Redirect SSO URL'si, SLO URL'si) belgedekiyle\ndeğişir; belgedeki süresi dolmamış imza sertifikalarından kayıtlı olmayanlar eklenir (`source = manual`), mevcutlar etkin\nkalır (silmek için `DELETE …/certificates/{certificate_id}`). Bağlantı yüklenen belgeye geçer: varsa metadata URL'si ve imza\nsabitlemesi temizlenir. Değişiklik son başarılı test girişini geçersiz kılar (etkinleştirme yeni test ister, KG-03).\n`mfa_authn_context_values` verilirse (boş liste dahil) IdP MFA beyanı sayılan AuthnContext değerleri yazılır;\nverilmezse değişmez. Metadata URL'si yolu bu uçta yoktur. Geçersiz belge `422 validation_failed`\n(`/metadata_xml`; ayrıştırıcının nedeni ve belgenin içeriği yanıtta ve logda yer almaz), 3 etkin sertifika sınırı aşılırsa\n`409 conflict` ve hiçbir şey değişmez; SAML olmayan bağlantı ya da SAML yapılandırması henüz oluşturulmamış bağlantı\n`409 conflict`. SAML malzemesinin sürümü olmadığından `If-Match` almaz. Yazma yönetim audit'ine\n`connection.idp_metadata_imported` (+ her yeni sertifika için `connection.idp_certificate_added`) olarak geçer. Etkin\nbağlantıda belge IdP entityID'sini ya da SSO URL'sini değiştiriyor ya da bir imza sabitlemesini kaldırıyorsa içe aktarım\nuygulanmaz, bütünüyle taslak revizyon olur: yanıt `200`, canlı IdP tarafını ve `revision`'ı taşır,\n`added_certificate_fingerprints` boştur; taslak `:test` gövdesinde `revision_id` ile denenip `…:publish` ile yayımlanır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", "{{connection_id}}:import-metadata" ], "raw": "{{baseUrl}}/connections/{{connection_id}}:import-metadata" } } }, { "name": "POST /v1/connections/{connection_id}:migrate-sp-host", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bağlantının SP uçlarını (`sp_host`) yeni bir host'a taşımayı başlatır: bağlantının\ndurumundan bağımsız olarak `kind = sp_host` türünde bir taslak revizyon oluşur, canlı uçlar değişmez. Taslakken yeni\nhost'ta yalnız SP metadata'sı (`GET …/sp-metadata?revision_id=` ve kamu metadata adresi) ve taslağın test girişi yanıt\nverir; IdP yöneticisi yeni metadata'yı IdP'ye yükler, taslak `:test` gövdesinde `revision_id` ile denenir ve\n`…/revisions/{revision_id}:publish` ile yayımlanır. Yayından sonra eski host'un uçları 30 gün daha çalışır, sonra `404`.\nBağlantının önceki taslağı varsa düşer (`superseded`). `sp_host` ortamın etkin host'u olmalıdır (küçük harf, port yok);\nbiçimsizse, ortamda değilse ya da zaten bağlantının host'uysa `422 validation_failed` (`/sp_host`; kod `invalid_value`,\n`not_in_environment`, `unchanged`). Önceki taşımanın 30 günlük penceresi sürerken ya da protokol yapılandırması yokken\n`409 conflict`. Kurumsal olmayan ya da bu ortamda olmayan bağlantı `404`'tür. Yazma yönetim audit'ine\n`connection.revision_created` olarak geçer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", "{{connection_id}}:migrate-sp-host" ], "raw": "{{baseUrl}}/connections/{{connection_id}}:migrate-sp-host" } } }, { "name": "POST /v1/connections/{connection_id}:restore", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Silinmiş bağlantıyı geri yükler. Silinen bağlantı 30 gün geri yüklenebilir; bu sürede listede görünmez,\nokunamaz (`404`) ve girişte kullanılamaz, sonra kalıcı silinir. Geri yüklenen bağlantı `status` = `inactive` olarak ve\nsilmeden önceki ayarlarıyla döner; kendiliğinden etkinleşmez (`:activate` ayrı adımdır, kurumsal bağlantıda test kapısı\nve plan kotası orada denetlenir). Uygulama bağlantı listeleri ve bağlantının rol eşlemeleri silmede düşer ve geri\ngelmez. Gövde isteğe bağlıdır ve alan içermez (`{}`). İşlem eşgüçlüdür: bağlantı zaten canlıysa yazma yapılmaz ve mevcut\nkaynak 200 ile döner. Bilinmeyen, başka ortamın ya da 30 günü geçmiş bağlantı `404`; aynı `key`, `name`, tek passkey\nya da tek sosyal sağlayıcı kuralıyla çakışma ve sahip organizasyonun silinmiş olması `409 conflict`; ortam başına\nbağlantı tavanı `403 quota_exceeded`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", "{{connection_id}}:restore" ], "raw": "{{baseUrl}}/connections/{{connection_id}}:restore" } } }, { "name": "POST /v1/connections/{connection_id}:test", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bağlantının güncel yapılandırmasıyla bir test girişi başlatır. Yanıttaki `test_url` (`https:///sso//start?t=…`) 10 dakika ve tek kullanım için geçerli bir\ntaşıyıcı bağlantıdır: yapılandırmayı yapan kişi tarayıcıda açar, IdP gidiş-dönüşünden sonra tarayıcı `return_url`'ye\n`test_id` sorgu parametresiyle döner. URL yalnız bu yanıtta bir kez döner (`Cache-Control: no-store`), loglanmaz ve\naudit'e yazılmaz; `Idempotency-Key` ile tekrar oynatılan yanıtta `test_url` yoktur ve `secret_redacted: true` döner. Test\ngirişi oturum açmaz, JIT yapmaz, hesap bağlamaz; sonuç `GET …/test-results/latest` ile 24 saat okunur. `return_url`\nmutlak `https` URL'dir (en çok 2048 bayt; değilse `422 validation_failed`, `/return_url`). Henüz test edilemeyen bağlantı\n(protokol yapılandırması yok ya da kullanılamaz) `409 conflict`. Başlatma yönetim audit'ine `connection.test_started`\n(yalnız test kimliği) olarak geçer. `revision_id` (`connrev_…`) verilirse bağlantının taslak revizyonu canlı\nyapılandırmanın üstüne serilerek denenir (SP host taşımasında yeni host'ta); bu test yalnız o revizyonun yayım kanıtıdır,\ncanlı yapılandırmanın etkinleştirme kanıtı sayılmaz. Biçimsiz ya da bu bağlantının taslağı olmayan\n`revision_id` `422 validation_failed` (`/revision_id`; kod `invalid_value` ya da `not_found`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "connections", "{{connection_id}}:test" ], "raw": "{{baseUrl}}/connections/{{connection_id}}:test" } } } ], "name": "connections" }, { "description": "`/v1/consent-purposes` kaynak ailesi.", "item": [ { "name": "GET /v1/consent-purposes", "request": { "description": "İskelet işlem; davranış plan satırındadır. Not: GA sonrası (plan: GA'da user_metadata ile geçici)", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "consent-purposes" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/consent-purposes" } } }, { "name": "POST /v1/consent-purposes", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: bkz. listConsentPurposes", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "consent-purposes" ], "raw": "{{baseUrl}}/consent-purposes" } } }, { "name": "PATCH /v1/consent-purposes", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: plan PATCH'i koleksiyon yolunda yazıyor", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "consent-purposes" ], "raw": "{{baseUrl}}/consent-purposes" } } } ], "name": "consent-purposes" }, { "description": "`/v1/custom-domains` kaynak ailesi.", "item": [ { "name": "GET /v1/custom-domains", "request": { "description": "Ortamın özel giriş alan adlarını imleçli listeler. Sıralama her zaman oluşturma sırasıyla\neskiden yeniyedir ve yalnız ileri sayfalama (`after`) vardır; `before` ve `asc` dışı `order` `422` döner.\nVarsayılan olarak bırakılmış (`released`) kayıtlar dönmez: `include_released=true` ile katılır; `status` verilirse\nyalnız o durumdaki kayıtlar döner (`status=released` dahil). Ortam başına en çok 1 (Enterprise'da 20) kayıt olur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "custom-domains" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Yalnız bu durumdaki kayıtlar (`released` dahil olabilir).", "disabled": true, "key": "status", "value": "" }, { "description": "true ise bırakılmış (`released`) kayıtlar da döner; `status` verilmişse yok sayılır.", "disabled": true, "key": "include_released", "value": "" } ], "raw": "{{baseUrl}}/custom-domains" } } }, { "name": "POST /v1/custom-domains", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortama bir özel giriş alan adı ekler. Ad IDNA2008 ile A-etiketine çevrilir; genel sonek, tek etiketli ad,\nIP adresi, platform alanları (`keenauth.com`, `keenauth.app` ve altları) `422` (kod `invalid_value`) verir. Ad\nplatform genelinde tekildir: başka bir ortamda kayıtlıysa ya da bırakıldıktan sonraki 30 günlük karantinadaysa\n`409 custom_domain_taken`. Ortam başına kota planınkidir (`custom_domains_per_environment`; dolu kota ve\n`development` ortamı `403 quota_exceeded`); hesap başına günlük ekleme deneme sınırı `429 rate_limited`.\n`Idempotency-Key` zorunludur: aynı anahtar ve aynı ad aynı kaydı döndürür, aynı anahtar farklı adla `422\nidempotency_key_reuse` verir. Kayıt `pending_dns` durumunda doğar; yanıttaki `dns_records` müşterinin DNS'ine\neklenecek TXT (sahiplik) ve CNAME (yönlendirme) kayıtlarıdır. Kontrol düzlemi kayıt defterine ya da ortamın\nhesap bilgisine erişilemezse `503`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Bu işlemde zorunlu; yoksa 400 malformed_request.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "custom-domains" ], "raw": "{{baseUrl}}/custom-domains" } } }, { "name": "GET /v1/custom-domains/{custom_domain_id}", "request": { "description": "Bir özel alan kaydını döndürür. Kayıt CAA yüzünden engelliyse (`failure_reason = caa_blocked`) `caa` alanı canlı\nCAA ön denetiminin sonucunu ve DNS'e eklenecek tam CAA satırlarını taşır; diğer durumlarda ve denetim yapılamazsa `caa` alanı yoktur.\nBiçimsiz ya da başka ortamın kimliği `404 not_found` döner. `ETag` başlığı silme ve birincil yapma için\n`If-Match` değeridir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "custom-domains", ":custom_domain_id" ], "raw": "{{baseUrl}}/custom-domains/:custom_domain_id", "variable": [ { "description": "Özel alanın önekli dış kimliği (`cdom_…`).", "key": "custom_domain_id", "value": "" } ] } } }, { "name": "DELETE /v1/custom-domains/{custom_domain_id}", "request": { "description": "Özel alanı kaldırır: kayıt `released` olur, giriş o alanda durur ve ad platformda 30 gün karantinada kalır (başka\nbir ortam ekleyemez). Birincil alan ya da ortamın issuer'ı olan alan kaldırılamaz (`409 custom_domain_in_use`;\nönce başka bir alanı birincil yapın). Passkey bağlantısının rpId'si olan ya da süren rpId göçünün önceki rpId'si\nolan alan da kaldırılamaz. `If-Match` zorunludur (yoksa `428`, eşleşmezse `412`). Zaten bırakılmış\nkayıtta yalnız kayıt defterinden bırakma yinelenir. Kontrol düzlemine ya da ortamın issuer bilgisine\nerişilemezse `503`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "custom-domains", ":custom_domain_id" ], "raw": "{{baseUrl}}/custom-domains/:custom_domain_id", "variable": [ { "description": "Özel alanın önekli dış kimliği (`cdom_…`).", "key": "custom_domain_id", "value": "" } ] } } }, { "name": "POST /v1/custom-domains/{custom_domain_id}:make-primary", "request": { "description": "Alanı ortamın birincil özel alanı yapar (barındırılan giriş bağlantıları bu alanı kullanır); önceki birincil aynı\nişlemde bırakılır. Alan `active` olmalıdır (aksi `409 custom_domain_state_conflict`); zaten birincilse değişiklik\nyoktur. Ortamın issuer'ı özel alandaysa birincil değişikliği issuer'ı değiştirir ve zamanlanmış issuer geçişi\nister. `If-Match` isteğe bağlıdır; verilirse eşleşmezse `412`.\nGövde yoktur. Ortamın issuer bilgisine erişilemezse `503`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "custom-domains", "{{custom_domain_id}}:make-primary" ], "raw": "{{baseUrl}}/custom-domains/{{custom_domain_id}}:make-primary" } } }, { "name": "POST /v1/custom-domains/{custom_domain_id}:verify", "request": { "description": "DNS denetimini (TXT sahiplik kaydı, CNAME, CAA; DNSSEC doğrulayan çözücüyle) hemen çalıştırır ve sonucu kaydın\ndurumuna uygular; güncel kaydı döndürür. `disabled` ya da deneme penceresi dolmuş `pending_dns` kayıt önce\nyeniden başlatılır. `released` kayıtta `409 custom_domain_state_conflict`; denetim eşzamanlı bir denetimle\nçakışırsa `409 conflict` (yeniden deneyin). Gövde yoktur. Hücrenin DNS çözücüsü bu\ndağıtımda yapılandırılmamışsa `503` (sonuçsuz denetim başarı gibi görünmesin diye).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "custom-domains", "{{custom_domain_id}}:verify" ], "raw": "{{baseUrl}}/custom-domains/{{custom_domain_id}}:verify" } } } ], "name": "custom-domains" }, { "description": "`/v1/directories` kaynak ailesi.", "item": [ { "name": "GET /v1/directories", "request": { "description": "Ortamın SCIM dizinlerini yeniden eskiye (`created_at`, sonra kimlik) imleçli listeler; yalnız ileri sayfalama vardır\n(`before` ve `order` `422 unsupported`). Süzgeçler: `organization_id`, `type`, `state`; imleç süzgeçlere bağlıdır.\nYanıt kişisel veri, token ya da token özeti taşımaz; açık toplu pasifleştirme bekletmesi yalnız tek dizin\nokumasındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories" ], "query": [ { "description": "Yalnız bu org'un dizinleri (`org_…`).", "disabled": true, "key": "organization_id", "value": "" }, { "description": "Yalnız bu türdeki dizinler.", "disabled": true, "key": "type", "value": "" }, { "description": "Yalnız bu durumdaki dizinler.", "disabled": true, "key": "state", "value": "" }, { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/directories" } } }, { "name": "POST /v1/directories", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Org için etkin olmayan (`inactive`) bir SCIM dizini ve ilk token'ını oluşturur. Dizinin SCIM\ntaban URL'si `https:///scim/v2/`'dir; `scim_host` ortamın birincil host'u olmalıdır (etkin özel alan\nadı, yoksa `..keenauth.app`) ve bu ortama yönlenmelidir (aksi `422`, `/scim_host`). Org bu ortamda yoksa\n`404`; silme kuyruğundaysa `409 organization_pending_deletion`, başka biçimde etkin değilse `409 organization_disabled`.\nSCIM token'ı (`token`) YALNIZ bu yanıtta, bir kez döner ve sonradan hiçbir uçtan okunamaz (yanıt `Cache-Control:\nno-store` taşır). `Idempotency-Key` ile tekrar oynatılan yanıt (`Idempotent-Replayed: true`) token içermez ve\n`secret_redacted: true` döner; token kaybedildiyse yenisi `POST …/tokens` ile oluşturulur. Yazma\n`directory.created` ve `directory.token_created` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories" ], "raw": "{{baseUrl}}/directories" } } }, { "name": "GET /v1/directories/{directory_id}", "request": { "description": "Tek SCIM dizinini açık toplu pasifleştirme bekletmesiyle döner. Dizin yoksa ya da başka\nortamdaysa `404`. Token'ların üst verisi `GET …/tokens`'tadır. `ETag` başlığı `PATCH` için `If-Match` değeridir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id" ], "raw": "{{baseUrl}}/directories/:directory_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "DELETE /v1/directories/{directory_id}", "request": { "description": "Dizini sert ve anında siler: token'ları (dizinin SCIM istekleri bundan sonra `401`),\nbekletmeleri, grupları, grup üyelikleri ve dizin kullanıcı kayıtları aynı işlemde silinir; yanıt gövdesizdir. Dizin\nyoksa, başka ortamdaysa ya da zaten silinmişse `404`. Yazma `directory.deleted` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id" ], "raw": "{{baseUrl}}/directories/:directory_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "PATCH /v1/directories/{directory_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Dizin ayarlarını RFC 7396 birleştirme yamasıyla günceller (`application/merge-patch+json`). `If-Match` zorunludur (yoksa\n`428`, eşleşmezse `412`); güncel sürüm `GET /v1/directories/{directory_id}` yanıtının `ETag` başlığındadır. Değişebilen\nalanlar: `name`, `provisioning_mode`, `attribute_allowlist`, `unverified_domain_action`, `delete_action`,\n`on_delete_memberships`, `mass_deprovision_guard`, `send_welcome_email`; hiçbiri `null` olamaz. Geçersiz değer `422`\nve alanın işaretçisidir. `provisioning_mode` dizinde silinmemiş kullanıcı kaydı varken değişmez (`409 conflict`).\n`attribute_allowlist`'ten çıkarılan öznitelik dizinin kullanıcı kayıtlarından aynı işlemde silinir. Değişiklik içermeyen\nyama yazma yapmaz ve sürümü artırmaz. Yazma `directory.updated` audit kaydıdır (değişen ayarın eski ve yeni değeri).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id" ], "raw": "{{baseUrl}}/directories/:directory_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "GET /v1/directories/{directory_id}/deprovision-holds", "request": { "description": "Dizinin toplu pasifleştirme bekletmelerini (açık ve karara bağlanmış) yeniden eskiye imleçli listeler: yalnız sayı, durum ve karar; bekletilen kullanıcı listesi yoktur. Yalnız ileri sayfalama vardır;\nimleç dizine bağlıdır. Dizin yoksa ya da başka ortamdaysa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "deprovision-holds" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/directories/:directory_id/deprovision-holds", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "POST /v1/directories/{directory_id}/deprovision-holds/{hold_id}:approve", "request": { "description": "Dizinin toplu pasifleştirme bekletmesini onaylar: bekletilen pasifleştirmeler\nuygulanır. Gövde yoktur. Bekletme kimliği `GET /v1/directories/{directory_id}` yanıtındaki `open_deprovision_hold.id`\ndeğeridir. Bekletme ya da dizin yoksa veya başka ortamdaysa `404`; karar verilmiş bekletme ve 72 saati geçmiş\nbekletme (zaman aşımıyla onaylanır, bu karar uygulanmaz) `409 conflict`. Yazma `directory.deprovision_hold_approved`\naudit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "deprovision-holds", "{{hold_id}}:approve" ], "raw": "{{baseUrl}}/directories/:directory_id/deprovision-holds/{{hold_id}}:approve", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "POST /v1/directories/{directory_id}/deprovision-holds/{hold_id}:reject", "request": { "description": "Dizinin toplu pasifleştirme bekletmesini reddeder: bekletilen pasifleştirmeler\natılır ve kayıtlar sapmış (drifted) işaretlenir. Gövde yoktur. Bekletme ya da dizin yoksa veya başka ortamdaysa `404`;\nkarar verilmiş bekletme ve 72 saati geçmiş bekletme `409 conflict`. Yazma `directory.deprovision_hold_rejected`\naudit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "deprovision-holds", "{{hold_id}}:reject" ], "raw": "{{baseUrl}}/directories/:directory_id/deprovision-holds/{{hold_id}}:reject", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "GET /v1/directories/{directory_id}/groups", "request": { "description": "Dizinin IdP'nin sağladığı gruplarını kimlik sırasıyla imleçli listeler: kimlik, dış kimlik, görünen\nad ve üye sayısı; üye ve kişisel veri yoktur. Yalnız ileri sayfalama vardır; imleç dizine bağlıdır. Dizin yoksa ya da\nbaşka ortamdaysa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "groups" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/directories/:directory_id/groups", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "GET /v1/directories/{directory_id}/groups/{directory_group_id}", "request": { "description": "Dizinin tek grubunu döner: kimlik, dış kimlik, görünen ad ve üye sayısı; üye ve kişisel veri\nyoktur. Grup yoksa, başka dizinin grubuysa ya da dizin başka ortamdaysa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "groups", ":directory_group_id" ], "raw": "{{baseUrl}}/directories/:directory_id/groups/:directory_group_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_group_id", "value": "" } ] } } }, { "name": "GET /v1/directories/{directory_id}/provisioning-logs", "request": { "description": "Dizinin provizyon günlüğünü yeniden eskiye imleçli listeler; sıralama\nher zaman `occurred_at` azalandır, `order` parametresi yoktur. Her kayıt bir kimliği doğrulanmış SCIM isteğidir:\nyöntem, yol şablonu (gerçek kimlik yolda değil), kaynak türü ve kimliği, işlem özeti (değer değil), yok sayılan\nöznitelik adları, durum, `scim_type`, süre, istemci adres öneki (/24 ya da /48), istemci sınıfı ve devre kesici\nbayrağı. İstek ve yanıt gövdeleri, öznitelik değerleri, tam IP, User-Agent ve token değeri saklanmaz ve dönmez.\nSaklama penceresi ortamın planından sunucuda uygulanır (Free 7, Startup 14, Business 30, Enterprise 90 gün);\npencere dışı `from` `400 range_outside_retention` döner. Dizin yoksa ya da başka ortamdaysa `404`; silinmiş dizinin\nkayıtları `GET /v1/logs?type=scim.request` ile okunur. Toplam sayı döndürülmez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "provisioning-logs" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "description": "Dahil alt sınır (RFC 3339). Yoksa saklama penceresinin başı; pencere dışı değer `400 range_outside_retention` döner.", "disabled": true, "key": "from", "value": "" }, { "description": "Hariç üst sınır (RFC 3339). Yoksa şimdi; `from` verilmişse ondan sonra olmalıdır.", "disabled": true, "key": "to", "value": "" } ], "raw": "{{baseUrl}}/directories/:directory_id/provisioning-logs", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "GET /v1/directories/{directory_id}/role-mappings", "request": { "description": "SCIM dizininin grup → rol eşlemelerini kimlik sırasıyla (eskiden yeniye) imleçli listeler; yalnız ileri sayfalama\nvardır. İmleç dizine bağlıdır. Dizin yoksa ya da başka ortamdaysa `404`; dizin kaydı doğrulanamazsa `503`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "role-mappings" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/directories/:directory_id/role-mappings", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "POST /v1/directories/{directory_id}/role-mappings", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Dizinin bir grubunu (`directory_group_id`, `dsg_…`) bir role (`rol_…`) eşler; grubun üyeleri dizinin org'unda rolü\nalır. Grup bu dizinin grubu olmalıdır (yoksa `422 validation_failed`, `/directory_group_id` `unknown_group`). Rol\nortam rolü ya da dizinin org'unun rolü olmalıdır. Ayrıcalıklı role eşleme ek olarak `roles:write` ister ve onaylı oluşur. Aynı grup dizinde zaten eşlenmişse `409 conflict`; dizin\nsiliniyorsa `409 conflict`; dizin başına 500 eşleme (`409 role_mapping_limit_reached`); dizin kaydı doğrulanamazsa\n`503`. Yazma `role_mapping.created` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "role-mappings" ], "raw": "{{baseUrl}}/directories/:directory_id/role-mappings", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "DELETE /v1/directories/{directory_id}/role-mappings/{mapping_id}", "request": { "description": "Eşlemeyi siler; yanıt gövdesizdir. Eşleme yoksa ya da başka dizin veya ortamdaysa `404`. Dizin silinmiş olsa da\neşlemesi silinebilir. Eşlemeyle verilmiş roller yeniden hesaplanır. Silme `role_mapping.deleted` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "role-mappings", ":mapping_id" ], "raw": "{{baseUrl}}/directories/:directory_id/role-mappings/:mapping_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "mapping_id", "value": "" } ] } } }, { "name": "GET /v1/directories/{directory_id}/tokens", "request": { "description": "Dizinin token'larının üst verisini yeniden eskiye imleçli listeler (iptal edilmiş ve süresi dolmuş token'lar dahil);\ntoken değeri ve özeti hiç dönmez. Yalnız ileri sayfalama vardır; imleç dizine bağlıdır. Dizin yoksa ya da başka\nortamdaysa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "tokens" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/directories/:directory_id/tokens", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "POST /v1/directories/{directory_id}/tokens", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Rotasyon için dizine yeni bir SCIM token'ı üretir. Dizin başına en çok 2 geçerli token olur; üçüncüsü `409\nconflict` (önce eskisi iptal edilir). Token (`token`) YALNIZ bu yanıtta, bir kez döner ve sonradan hiçbir uçtan\nokunamaz (yanıt `Cache-Control: no-store` taşır); `Idempotency-Key` ile tekrar oynatılan yanıt token içermez ve\n`secret_redacted: true` döner. Boş nesne (`{}`) varsayılanları kullanır. Dizin yoksa ya da başka ortamdaysa\n`404`. Yazma `directory.token_created` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "tokens" ], "raw": "{{baseUrl}}/directories/:directory_id/tokens", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "DELETE /v1/directories/{directory_id}/tokens/{token_id}", "request": { "description": "Token'ı hemen iptal eder (neden `manual`); yanıt gövdesizdir ve zaten iptal edilmiş token da `204`'tür. Token\nkimliği küçük harf UUID metnidir. Token ya da dizin yoksa, token başka dizinin ya da başka ortamınsa `404`. Yazma\n`directory.token_revoked` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "tokens", ":token_id" ], "raw": "{{baseUrl}}/directories/:directory_id/tokens/:token_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "token_id", "value": "" } ] } } }, { "name": "GET /v1/directories/{directory_id}/users", "request": { "description": "Dizinin IdP'nin sağladığı canlı kullanıcı kayıtlarını kimlik sırasıyla imleçli listeler: normalize öznitelikler, gruplar, ortam kullanıcısı bağı ve sapma bayrağı. Silinmiş kayıt\ndönmez. `state` ve `group_id` süzgeçleri birlikte kullanılabilir; imleç dizine ve süzgeçlere bağlıdır, yalnız ileri\nsayfalama vardır. Kimlik bilgisi `users:read_pii` iznini taşımıyorsa kişisel veri maskelenir: `user_name` ilk\nkarakter ve `***`, `emails[].value` `a***@e***.com` biçiminde, `given_name`, `family_name` ve `display_name` baş harfler\nolur; `attributes` hiç verilmez (`null`). Dizin yoksa ya da başka ortamdaysa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "users" ], "query": [ { "description": "Yalnız bu durumdaki dizin kullanıcıları; başka değer `422`.", "disabled": true, "key": "state", "value": "" }, { "description": "Yalnız bu dizin grubunun (`dsg_…`) üyeleri; başka dizinin grubu boş sonuç verir.", "disabled": true, "key": "group_id", "value": "" }, { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/directories/:directory_id/users", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" } ] } } }, { "name": "GET /v1/directories/{directory_id}/users/{directory_user_id}", "request": { "description": "Dizinin tek kullanıcı kaydını döner. Kayıt silinmişse, yoksa, başka dizinin ya da başka\nortamın kaydıysa `404`. Kimlik bilgisi `users:read_pii` iznini taşımıyorsa kişisel veri `GET\n/v1/directories/{directory_id}/users` işlemindeki biçimle maskelenir ve `attributes` `null` döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", ":directory_id", "users", ":directory_user_id" ], "raw": "{{baseUrl}}/directories/:directory_id/users/:directory_user_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "directory_user_id", "value": "" } ] } } }, { "name": "POST /v1/directories/{directory_id}:activate", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Dizini etkinleştirir (`state` = `active`); pasifleştirilmiş dizin SCIM isteklerini yeniden kabul eder. Gövde isteğe\nbağlıdır ve alan içermez (`{}`). İşlem eşgüçlüdür: dizin zaten etkinse yazma yapılmaz, sürüm artmaz ve mevcut dizin 200\nile döner. `If-Match` almaz. Org'un zaten 3 etkin dizini varsa `409 conflict`. Yazma `directory.activated` audit kaydıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", "{{directory_id}}:activate" ], "raw": "{{baseUrl}}/directories/{{directory_id}}:activate" } } }, { "name": "POST /v1/directories/{directory_id}:deactivate", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Dizini pasifleştirir (`state` = `inactive`). Token'lar geçerli kalır ama dizin her SCIM isteğine geçersiz token ile aynı\n`401` yanıtını verir; hiç kullanılmamış dizin de ilk isteğiyle etkinleşmez. `:activate` ile geri alınır. Gövde isteğe\nbağlıdır ve alan içermez (`{}`). İşlem eşgüçlüdür: dizin zaten pasifleştirilmişse yazma yapılmaz, sürüm artmaz ve mevcut\ndizin 200 ile döner. `If-Match` almaz. Yazma `directory.deactivated` audit kaydıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", "{{directory_id}}:deactivate" ], "raw": "{{baseUrl}}/directories/{{directory_id}}:deactivate" } } }, { "name": "POST /v1/directories/{directory_id}:simulate", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "SCIM simülatörü: dizinin gerçek SCIM ucunu, yalnız bu çalıştırma için basılan ve\nbitince iptal edilen gerçek bir `idp_scim_` token'ıyla çağırır; scim servisinin üretim kod yolu çalışır. Kullanıcılar sabit kurgusal kümedir (25 kişi,\n`@example.test`, 5 grup); gerçek kişisel veri yoktur. Senaryolar: `seed` (25 kullanıcı + 5 grup; dolu dizinde ilk\nkullanıcıda SCIM `409` ile `failed`), `bulk_deactivate` (kullanıcıların %60'ı `active=false`; varsayılan korumada\n`absolute_min` 25 olduğundan 15 pasifleştirme kesiciyi açmaz, `absolute_min` ≤ 15 iken açar), `group_churn`,\n`attribute_update`, `conflict_email` (aynı `userName` ile `409` bekler). Boş dizinde `seed` dışındaki senaryolar\nönce `seed` çalıştırır. Yan etkilidir: yazılan kullanıcı ve gruplar dizinde kalır. Yalnız `development` ve `staging`\nortamında; üretimde `403 test_feature_not_in_production` (ortam türü kimlik bilgisinden okunur). Dizin başına aynı\nanda tek çalıştırma (ikincisi `409 conflict`); pasifleştirilmiş ya da silinmekte olan dizin `409 conflict`. SCIM\nhata yanıtı istek hatası değildir: `status` `failed` ve `failure` dolar, sayılar o ana kadar yapılanlardır. Simülasyon\ntoken'ı listelenmez, 2 token sınırına sayılmaz, müşterinin token'ını döndürmez (rotasyon başlatmaz). Audit:\n`directory.simulation_started` ve `directory.simulation_finished`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "directories", "{{directory_id}}:simulate" ], "raw": "{{baseUrl}}/directories/{{directory_id}}:simulate" } } } ], "name": "directories" }, { "description": "`/v1/email-provider` kaynak ailesi.", "item": [ { "name": "GET /v1/email-provider", "request": { "description": "Ortamın e-posta gönderim yapılandırmasını döndürür: kip, gönderen, müşterinin SMTP sunucusu ya da sağlayıcısı ve son\nbağlantı testi. Kimlik bilgisi hiçbir yanıtta yoktur (maskesi ya da uzunluğu da); yalnız `credentials_set` saklı bir sır\nolup olmadığını söyler. Satırı olmayan ortam `platform_default`, sürüm `0`'dır. `ETag` yapılandırmanın sürümüdür.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-provider" ], "raw": "{{baseUrl}}/email-provider" } } }, { "name": "PUT /v1/email-provider", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Yapılandırmayı değiştirir. Yazılabilen kipler `platform_default`, `platform_managed_domain` (doğrulanmış gönderici\nalanından platform sunucularıyla, DKIM imzalı), `customer_smtp` (465 ya da 587, TLS zorunlu), `customer_api`\n(`ses`, `sendgrid`, `postmark`, `mailgun`, `brevo`) ve `customer_webhook`'tur (çizilmiş e-posta, kayıtlı web kancası\nucuna Standard Webhooks v1 imzalı `email.send_requested` olayıyla verilir; e-postayı siz gönderirsiniz). `If-Match` zorunludur ve okunan sürümü taşır: satırı olmayan\nortamda `\"0\"` (orada `*` eşleşmez); eşleşmezse `412`. Kimlik bilgisi (`credentials`) bir kez yazılır ve hiçbir yanıtta\ndönmez; verilmezse saklı sır yalnız aynı kip ve hedefte (SMTP ana makinesi, port, kullanıcı adı ya da sağlayıcı)\nkorunur, hedef değişirse `422 validation_failed` ve `/credentials required`. `platform_managed_domain` yalnız üretim\nortamında yazılır (aksi `/mode production_only`), `sender_domain_id` ister (`/sender_domain_id required|invalid`); alan\nbu ortamda yoksa `/sender_domain_id not_found` (başka ortamın alanı da aynı yanıtı alır), doğrulanmamışsa\n`/sender_domain_id not_verified`, `from_address` tam o alanda değilse `/from_address not_in_sender_domain`.\n`customer_webhook` `webhook_endpoint_id` ister (`whe_…`, `/v1/webhook-endpoints`; `/webhook_endpoint_id\nrequired|invalid`); uç bu ortamda yoksa `/webhook_endpoint_id not_found` (başka ortamın ucu da aynı yanıtı alır), uç\netkin değilse `/webhook_endpoint_id not_enabled`; kimlik bilgisi, sağlayıcı ve SMTP alanı almaz. Müşteri kipleri\ngönderim yolu (çıkış vekili), `customer_webhook` hooks teslim bağlantısı, `platform_managed_domain` DKIM imzası\nyapılandırılmamış dağıtımda kabul edilmez: `422` ve `/mode delivery_mode_unavailable`. Kipin almadığı alan (ör. başka\nkipte `sender_domain_id`) `/mode fields_not_allowed`. Alan sonradan doğrulanmış durumdan çıkarsa gönderim alan yeniden\ndoğrulanana dek `platform_default` ile sürer; yapılandırma değişmez. Değişiklik son test sonucunu siler ve yönetim audit\nkaydı (`email_provider.updated`; yalnız kip, sağlayıcı ve `sender_domain_id`, adres ve sır asla) aynı işlemde yazılır.\nPlan kapısı yoktur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-provider" ], "raw": "{{baseUrl}}/email-provider" } } }, { "name": "POST /v1/email-provider:test", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Saklı müşteri bağlantısını ileti göndermeden dener: `customer_smtp` çıkış vekili üzerinden bağlanır, TLS kurar, kimlik\ndoğrular ve `QUIT` ile çıkar; `customer_api` sağlayıcının belgelenmiş salt okunur ucunu anahtarla çağırır. Sonuç\nbaşarısız olsa da `200` döner: `result` `ok` ya da sabit hata kodudur (ör. `smtp_auth_failed`, `smtp_tls_invalid`,\n`esp_auth_failed`, `esp_access_denied`, `egress_dns_failed`, `delivery_credentials_invalid`); sunucu metni dönmez.\nSonuç `last_test_at` ve `last_test_result` alanlarına yazılır, `ETag` değişmez; test sırasında yapılandırma değişirse\n`409 conflict`. Platform kiplerinde test edilecek bağlantı yoktur: `409 conflict` (`platform_managed_domain`'in\nalanı `POST /v1/email-sender-domains/{sender_domain_id}:verify` ile denetlenir). Ortam başına saatte 10 test\n(`429 rate_limited`, `Retry-After`). Gövde isteğe bağlıdır, verilirse boş nesnedir. Her test yönetim audit kaydı\n(`email_provider.tested`) yazar.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-provider:test" ], "raw": "{{baseUrl}}/email-provider:test" } } } ], "name": "email-provider" }, { "description": "`/v1/email-sender-domains` kaynak ailesi.", "item": [ { "name": "GET /v1/email-sender-domains", "request": { "description": "Ortamın doğrulanmış gönderici alanlarını oluşturma sırasıyla (eskiden yeniye) döndürür. Ortam başına\nen çok 10 alan olduğu için liste sayfalanmaz; imleç alanları her zaman null'dır. Her öğe müşterinin DNS'e gireceği kayıtları\n(`records`) taşır. Gönderici alanı yalnız `production` ortamındadır; diğer ortamlarda liste boştur. Plan kapısı yoktur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-sender-domains" ], "raw": "{{baseUrl}}/email-sender-domains" } } }, { "name": "POST /v1/email-sender-domains", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortama bir gönderici alanı ekler. Ad IDNA 2008 ile A-etiketine çevrilir (sondaki nokta atılır); IP adresi, tek etiketli ad,\ngenel sonek (ör. `co.uk`), platform alanları (`keenauth.com`, `keenauth.app` ve altları) ve DKIM kayıt adını 253 okteti\naşacak kadar uzun ad `422 validation_failed` (`/domain invalid`) verir; `production` dışı ortam `/domain production_only`.\nAd ortamda zaten kayıtlıysa `409 conflict`; ortamda 10 alan varsa `409 domain_limit_reached`. Alan `pending_dns` doğar;\nyanıttaki `records` müşterinin DNS'ine girilecek iki DKIM CNAME'i (`akp1`, `akp2`; rotasyon müşteri DNS'ine dokunmadan\nyapılır) ve dönüş yolu CNAME'idir. `Idempotency-Key` verilirse aynı istek aynı yanıtı oynatır. Ekleme yönetim audit kaydıyla\n(`email_sender_domain.created`) aynı işlemde yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-sender-domains" ], "raw": "{{baseUrl}}/email-sender-domains" } } }, { "name": "GET /v1/email-sender-domains/{sender_domain_id}", "request": { "description": "Bir gönderici alanını döndürür: durum, son denetimin sonuçları ve DNS kayıtları. Son denetimde `_dmarc` kaydı bulunmadıysa\n`records` zorunlu olmayan bir DMARC önerisi (`v=DMARC1; p=none`) de taşır. Biçimsiz ya da başka ortamın kimliği\n`404 not_found` döner. `ETag` alanın sürümüdür (her denetimde de artar) ve silmede `If-Match` değeridir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-sender-domains", ":sender_domain_id" ], "raw": "{{baseUrl}}/email-sender-domains/:sender_domain_id", "variable": [ { "description": "Gönderici alanının önekli dış kimliği (`sdom_…`).", "key": "sender_domain_id", "value": "" } ] } } }, { "name": "DELETE /v1/email-sender-domains/{sender_domain_id}", "request": { "description": "Gönderici alanını siler. Gönderim yapılandırması (`platform_managed_domain` kipi) alanı kullanıyorsa `409 conflict`: önce\n`PUT /v1/email-provider` ile başka bir kipe geçin. `If-Match` zorunludur (yoksa `428`, eşleşmezse `412`; `*` var olan her\nsürümle eşleşir). Silme yönetim audit kaydıyla (`email_sender_domain.deleted`) aynı işlemde yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-sender-domains", ":sender_domain_id" ], "raw": "{{baseUrl}}/email-sender-domains/:sender_domain_id", "variable": [ { "description": "Gönderici alanının önekli dış kimliği (`sdom_…`).", "key": "sender_domain_id", "value": "" } ] } } }, { "name": "POST /v1/email-sender-domains/{sender_domain_id}:verify", "request": { "description": "DNS denetimini (iki DKIM CNAME'i, dönüş yolu CNAME'i ve DMARC hizası) hemen çalıştırır, sonucu günlük denetimle aynı durum\nkurallarıyla uygular ve güncel alanı döndürür: gerekli kayıtların hepsi doğruysa `pending_dns` ya da `degraded` alan\n`verified` olur; `verified` alanda başarısız denetim 72 saat sürerse alan `degraded` olur. Kayıt kodları `ok`, `missing`,\n`wrong_target`, `lookup_failed`; DMARC `aligned`, `not_aligned`, `no_record`, `invalid_record`, `lookup_failed` (DMARC\nzorunlu değildir). Platform tarafından devre dışı bırakılmış alan `409 conflict`. Ortam başına saatte 20 denetim\n(`429 rate_limited`, `Retry-After`). Gövde yoktur. Her denetim yönetim audit kaydı (`email_sender_domain.checked`) yazar.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-sender-domains", "{{sender_domain_id}}:verify" ], "raw": "{{baseUrl}}/email-sender-domains/{{sender_domain_id}}:verify" } } } ], "name": "email-sender-domains" }, { "description": "`/v1/email-templates` kaynak ailesi.", "item": [ { "name": "GET /v1/email-templates", "request": { "description": "Özelleştirilebilir 26 e-posta ailesini plan sırasıyla döndürür: ailenin güvenlik ailesi olup olmadığı, iletinin göstermesi\ngereken platform değeri (`requires`), şablonda kullanılabilen Liquid değişkenleri ve sürümü olan diller. Liste sayfalanmaz\n(sabit ve sınırlı). Okuma her plandadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-templates" ], "raw": "{{baseUrl}}/email-templates" } } }, { "name": "GET /v1/email-templates/{family}/{locale}", "request": { "description": "Yuvanın en yeni sürümünü (varsayılan), yayındaki sürümünü (`?version=published`) ya da verilen sürümü (`?version=N`) döndürür.\n`ETag` yuvanın en yeni sürümüdür (`PUT` için `If-Match`). Bilinmeyen aile ya da dil, sürümü olmayan yuva ya da yayını\nolmayan yuvada `published` `404` döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-templates", ":family", ":locale" ], "query": [ { "description": "`published` ya da 1 ve üstü sürüm numarası; yoksa en yeni sürüm.", "disabled": true, "key": "version", "value": "" } ], "raw": "{{baseUrl}}/email-templates/:family/:locale", "variable": [ { "description": "Yol anahtarı.", "key": "family", "value": "" }, { "description": "Yol anahtarı.", "key": "locale", "value": "" } ] } } }, { "name": "PUT /v1/email-templates/{family}/{locale}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İçeriği yeni bir taslak sürüm olarak yazar; yayındaki sürüm değişmez. `If-Match` zorunludur ve okunan en yeni sürümü\ntaşır: sürümü olmayan yuvada `\"0\"` (orada `*` eşleşmez); eşleşmezse `412`. Yazmadan önce içerik gönderim yolunun\ndenetiminden geçer: Liquid sandbox'ı ve örnek verilerle çizim, dengeli HTML, ailenin kodu ya da bağlantısı hem HTML'de\nhem düz metinde, boyutlar. Hata `422 validation_failed` (ya da `template_forbidden_construct`) ve alan başına `errors[]`\nolur. Startup ve üstü planda; değilse `403 plan_feature_unavailable`. Yuvada en çok 50 sürüm saklanır (yayındaki hariç).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-templates", ":family", ":locale" ], "raw": "{{baseUrl}}/email-templates/:family/:locale", "variable": [ { "description": "Yol anahtarı.", "key": "family", "value": "" }, { "description": "Yol anahtarı.", "key": "locale", "value": "" } ] } } }, { "name": "GET /v1/email-templates/{family}/{locale}/versions", "request": { "description": "Yuvanın sürümlerini yeniden eskiye, içeriksiz döndürür (en çok 51: son 50 ve yayındaki). Liste sayfalanmaz. `ETag` yuvanın\nen yeni sürümüdür; sürümü olmayan yuvada liste boştur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-templates", ":family", ":locale", "versions" ], "raw": "{{baseUrl}}/email-templates/:family/:locale/versions", "variable": [ { "description": "Yol anahtarı.", "key": "family", "value": "" }, { "description": "Yol anahtarı.", "key": "locale", "value": "" } ] } } }, { "name": "POST /v1/email-templates/{family}/{locale}:preview", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kayıtlı bir sürümü (`{\"version\": N}`) ya da kaydedilmemiş içeriği örnek verilerle çizer ve platform çerçevesiyle (zorunlu\ngüvenlik bloğu, platform işareti) döndürür; hiçbir şey yazmaz ve göndermez. Örnek kod ve bağlantı her çağrıda rastgeledir.\nDoğrulama `PUT` ile aynıdır. Startup ve üstü planda.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-templates", ":family", "{{locale}}:preview" ], "raw": "{{baseUrl}}/email-templates/:family/{{locale}}:preview", "variable": [ { "description": "Yol anahtarı.", "key": "family", "value": "" } ] } } }, { "name": "POST /v1/email-templates/{family}/{locale}:publish", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Taslağı yeniden doğrular ve yayınlar; önceki yayın arşivlenir ve yönetim audit kaydı (`email_template.published`) aynı\nişlemde yazılır. Yayındaki sürümü yeniden yayınlamak değişiklik yapmaz. Yayındakinden eski taslak ya da arşivlenmiş sürüm\n`409 conflict` (arşivlenmiş sürüme `:rollback` ile dönülür). Startup ve üstü planda.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-templates", ":family", "{{locale}}:publish" ], "raw": "{{baseUrl}}/email-templates/:family/{{locale}}:publish", "variable": [ { "description": "Yol anahtarı.", "key": "family", "value": "" } ] } } }, { "name": "POST /v1/email-templates/{family}/{locale}:rollback", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Önceden yayınlanmış (arşivlenmiş) bir sürümün içeriğini yeniden doğrular ve yeni sürüm olarak yayınlar (`source_version`\no sürümdür); geçmiş yeniden yazılmaz. Audit kaydı (`email_template.rolled_back`) aynı işlemdedir. Hiç yayınlanmamış ya da\nyayındaki sürüm `409 conflict`. Startup ve üstü planda.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-templates", ":family", "{{locale}}:rollback" ], "raw": "{{baseUrl}}/email-templates/:family/{{locale}}:rollback", "variable": [ { "description": "Yol anahtarı.", "key": "family", "value": "" } ] } } }, { "name": "POST /v1/email-templates/{family}/{locale}:test-send", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Yuvanın bir sürümünü önizlemenin örnek verileriyle çizer ve tek bir alıcıya normal teslimat yoluyla gönderir; konu\n`[TEST] ` ile işaretlenir. Alıcı, hesabın `active` pano üyelerinden birinin doğrulanmış adresi olmalıdır (değilse\n`422 test_recipient_not_allowed`; adres yanıtta ve logda yer almaz); bu doğrulanamıyorsa gönderim yapılmaz\n(`503 test_recipient_source_unavailable`). Ortam başına UTC gününde en çok 20 deneme gönderimi; 21.si `429 rate_limited`\nve bir sonraki UTC gününe kadar `Retry-After`. Bastırma listesi atlanmaz: bastırılan alıcı için ileti `suppressed`\ndurumunda yazılır ve sayılır. `version` verilmezse en yeni sürüm, `published: true` ile yayındaki sürüm gönderilir.\nOrtamın gönderim modu ya da durumu özel şablon göndermiyorsa `409 email_template_not_deliverable`. Yönetim audit kaydı\n(`email_template.test_sent`, hedef aile/dil/sürüm) aynı işlemde yazılır. Aynı `Idempotency-Key` ile tekrar ilk iletiyi\ndöndürür ve sayılmaz. Startup ve üstü planda.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "email-templates", ":family", "{{locale}}:test-send" ], "raw": "{{baseUrl}}/email-templates/:family/{{locale}}:test-send", "variable": [ { "description": "Yol anahtarı.", "key": "family", "value": "" } ] } } } ], "name": "email-templates" }, { "description": "`/v1/environment` kaynak ailesi.", "item": [ { "name": "GET /v1/environment", "request": { "description": "Çağıranın kendi ortamını salt okunur döndürür: kimlik, tür, bölge, hücre, durum ve plan. Ortam yalnız\nkimlik bilgisinden çözülür; başka ortamı okumanın yolu yoktur. Kimlik, tür ve hücre doğrulanmış ortam kapsamından,\ndurum ve plan her istekte hücre ortam kayıt defterinden okunur (önbellek yok). Plan kapısı yoktur (her planda);\nyanıt `ETag` taşımaz (yazma yok). Görünen ad, oluşturulma anı ve varsayılan host bu sürümde yoktur; özel alan\nadları `/v1/custom-domains`'tedir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "environment" ], "raw": "{{baseUrl}}/environment" } } }, { "name": "POST /v1/environment:restore", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: izin planda yazılmamış (yalnız hesap owner)", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "environment:restore" ], "raw": "{{baseUrl}}/environment:restore" } } } ], "name": "environment" }, { "description": "`/v1/environment-settings` kaynak ailesi.", "item": [ { "name": "GET /v1/environment-settings", "request": { "description": "Ortamın dil, saat dilimi, oturum, kayıt, güvenlik bildirimi, hesap kurtarma, MFA, Front-Channel Logout ve izin\nverilen birinci faktör ayarlarını döndürür (ortam başına tekil kaynak; saldırı koruması `/v1/attack-protection`'dadır). Ayar hiç yazılmadıysa tablo\nvarsayılanları ve `ETag: \"0\"` döner; `updated_at` null'dır. Yanıt `ETag` başlığı taşır (`PATCH` için `If-Match`).\nSüreler tam saniye tamsayısıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "environment-settings" ], "raw": "{{baseUrl}}/environment-settings" } } }, { "name": "PATCH /v1/environment-settings", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortam ayarlarını RFC 7396 birleştirme yamasıyla günceller (`application/merge-patch+json`; gruplar iç içe\nbirleştirilir). `If-Match` zorunludur (yoksa `428`, eşleşmezse `412`); ayar hiç yazılmadıysa sürüm `\"0\"`'dır ve\nilk yazma satırı açar. `signup.email_domains` ve `security_notifications.events` için `null` listeyi temizler;\nöbür alanlar ve gruplar `null` olamaz (`422`, kod `invalid`). Geçersiz değer `422 validation_failed` ve alan\nişaretçisiyle döner (kodlar: `required`, `out_of_range`, `unknown_value`, `unsupported_locale`, `default_locale_not_enabled`,\n`invalid_zoneinfo`, `invalid_domain`, `invalid_url`, `too_long`, `too_many`, `duplicate`, `idle_exceeds_absolute`,\n`invalid_value`). Değişiklik içermeyen yama yazma yapmaz ve sürümü artırmaz. Oturum süresini kısaltmak, eşzamanlı\noturum sınırını düşürmek, kayıt ya da hesap kurtarmayı daraltmak, e-posta ikinci faktörünü `mfa`'dan `1fa`'ya\nindirmek ve `allowed_first_factors`'tan bir faktör çıkarmak yeni oturum ve girişlere hemen uygulanır; var olan oturumlar kendi ömrüne kadar sürer. Audit kaydı ve\nolay değişen alan adlarını taşır, değerleri değil. Yeni `allowed_first_factors`, kendi kümesini yazmış bir uygulamayla\nortak yöntem bırakmıyorsa ya da bir org politikasıyla org bağlamında ortak yöntem bırakmıyorsa `422 policy_conflict`\ndöner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "environment-settings" ], "raw": "{{baseUrl}}/environment-settings" } } } ], "name": "environment-settings" }, { "description": "`/v1/environments` kaynak ailesi.", "item": [ { "name": "GET /v1/environments/{environment_id}/customer-key/wrapping-key", "request": { "description": "İskelet işlem; davranış plan satırındadır. Not: bkz. importCustomerKey", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "environments", ":environment_id", "customer-key", "wrapping-key" ], "raw": "{{baseUrl}}/environments/:environment_id/customer-key/wrapping-key", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "environment_id", "value": "" } ] } } }, { "name": "POST /v1/environments/{environment_id}/customer-key:cancel-destroy", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: bkz. importCustomerKey", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "environments", ":environment_id", "customer-key:cancel-destroy" ], "raw": "{{baseUrl}}/environments/:environment_id/customer-key:cancel-destroy", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "environment_id", "value": "" } ] } } }, { "name": "POST /v1/environments/{environment_id}/customer-key:destroy", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: bkz. importCustomerKey", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "environments", ":environment_id", "customer-key:destroy" ], "raw": "{{baseUrl}}/environments/:environment_id/customer-key:destroy", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "environment_id", "value": "" } ] } } }, { "name": "POST /v1/environments/{environment_id}/customer-key:import", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: yalnız pano owner + adım yükseltme", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "environments", ":environment_id", "customer-key:import" ], "raw": "{{baseUrl}}/environments/:environment_id/customer-key:import", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "environment_id", "value": "" } ] } } }, { "name": "POST /v1/environments/{environment_id}/customer-key:resume", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: bkz. importCustomerKey", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "environments", ":environment_id", "customer-key:resume" ], "raw": "{{baseUrl}}/environments/:environment_id/customer-key:resume", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "environment_id", "value": "" } ] } } }, { "name": "POST /v1/environments/{environment_id}/customer-key:suspend", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: bkz. importCustomerKey", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "environments", ":environment_id", "customer-key:suspend" ], "raw": "{{baseUrl}}/environments/:environment_id/customer-key:suspend", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "environment_id", "value": "" } ] } } } ], "name": "environments" }, { "description": "`/v1/event-types` kaynak ailesi.", "item": [ { "name": "GET /v1/event-types", "request": { "description": "Müşteri olay kataloğunu döndürür: bir web kancası ucunun abone olabildiği ve `GET /v1/events`'in döndürebildiği her tür, yayımlanmış şema sürümleri (eskiden yeniye; ucun varsayılanı ilkidir) ve yüksek hacim işareti. Yüksek hacimli türler \"tümü\" aboneliğine girmez, adıyla seçilir. Katalog ortamdan bağımsızdır; sıralama anahtarı tür adıdır (varsayılan azalan, `order=asc` artan). Plan kapısı yoktur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "event-types" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/event-types" } } } ], "name": "event-types" }, { "description": "`/v1/events` kaynak ailesi.", "item": [ { "name": "GET /v1/events", "request": { "description": "Ortamın müşteri olaylarını `seq` sırasıyla, eskiden yeniye döndürür. Olaylar web kancasıyla aynı zarfı ve aynı `id`'yi taşır; saklama 30 gündür. Yanıt `next_cursor` + `has_more` zarfıdır: `next_cursor` her zaman doludur (son konum), yoklayan istemci yeni olay olmasa da bu konumdan sürer; `has_more` doğruysa beklemeden yeniden ister. `after=latest` olay döndürmez, imleci ortamın son olayına koyar. `payload=full` ayrıca `users:read` ister. `purpose=webhooks_listen` üretim ortamında `403 test_feature_not_in_production`'dır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "events" ], "query": [ { "description": "Önceki yanıtın `next_cursor` değeri ya da `latest` (yalnız bundan sonraki olaylar). Yoksa en eski saklanan olaydan başlar. Başka ortamın ya da bozuk imleç `400 invalid_cursor`.", "disabled": true, "key": "after", "value": "" }, { "description": "Virgülle ayrılmış olay türleri (en çok 20, örneğin `user.created,user.deleted`); yoksa bütün türler.", "disabled": true, "key": "types", "value": "" }, { "description": "Yalnız bu organizasyonun bağlamındaki olaylar (`org_…`).", "disabled": true, "key": "org_id", "value": "" }, { "disabled": true, "key": "limit", "value": "" }, { "description": "Yük kipi. `full` kimlik bilgisinin ayrıca `users:read` taşımasını ister (yoksa `403 insufficient_permissions`); zenginleştirme gelene kadar `full` de ince yükü taşır.", "disabled": true, "key": "payload", "value": "" }, { "description": "İsteğin amacı. `webhooks_listen` (CLI `webhooks listen`) yalnız `development` ve `staging` ortamında çalışır; üretimde `403 test_feature_not_in_production`.", "disabled": true, "key": "purpose", "value": "" } ], "raw": "{{baseUrl}}/events" } } }, { "name": "GET /v1/events/{event_id}", "request": { "description": "Bir müşteri olayını web kancasıyla aynı zarfla (ince yük) döndürür. Biçimsiz, başka ortamın ya da 30 günlük saklamanın dışındaki olay `404 not_found`'dur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "events", ":event_id" ], "raw": "{{baseUrl}}/events/:event_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "event_id", "value": "" } ] } } } ], "name": "events" }, { "description": "`/v1/fga` kaynak ailesi.", "item": [ { "name": "GET /v1/fga/authorization-model", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "fga", "authorization-model" ], "raw": "{{baseUrl}}/fga/authorization-model" } } }, { "name": "PUT /v1/fga/authorization-model", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "fga", "authorization-model" ], "raw": "{{baseUrl}}/fga/authorization-model" } } }, { "name": "POST /v1/fga/check", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "fga", "check" ], "raw": "{{baseUrl}}/fga/check" } } }, { "name": "POST /v1/fga/check:batch", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "fga", "check:batch" ], "raw": "{{baseUrl}}/fga/check:batch" } } }, { "name": "POST /v1/fga/list-objects", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "fga", "list-objects" ], "raw": "{{baseUrl}}/fga/list-objects" } } }, { "name": "POST /v1/fga/list-users", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "fga", "list-users" ], "raw": "{{baseUrl}}/fga/list-users" } } }, { "name": "GET /v1/fga/tuples", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "fga", "tuples" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/fga/tuples" } } }, { "name": "POST /v1/fga/tuples:write", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "fga", "tuples:write" ], "raw": "{{baseUrl}}/fga/tuples:write" } } } ], "name": "fga" }, { "description": "`/v1/hooks` kaynak ailesi.", "item": [ { "name": "GET /v1/hooks", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/hooks" } } }, { "name": "POST /v1/hooks", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks" ], "raw": "{{baseUrl}}/hooks" } } }, { "name": "GET /v1/hooks/{hook_id}", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks", ":hook_id" ], "raw": "{{baseUrl}}/hooks/:hook_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "hook_id", "value": "" } ] } } }, { "name": "DELETE /v1/hooks/{hook_id}", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks", ":hook_id" ], "raw": "{{baseUrl}}/hooks/:hook_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "hook_id", "value": "" } ] } } }, { "name": "PATCH /v1/hooks/{hook_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks", ":hook_id" ], "raw": "{{baseUrl}}/hooks/:hook_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "hook_id", "value": "" } ] } } }, { "name": "GET /v1/hooks/{hook_id}/executions", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks", ":hook_id", "executions" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/hooks/:hook_id/executions", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "hook_id", "value": "" } ] } } }, { "name": "PUT /v1/hooks/{hook_id}/secrets/{name}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks", ":hook_id", "secrets", ":name" ], "raw": "{{baseUrl}}/hooks/:hook_id/secrets/:name", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "hook_id", "value": "" }, { "description": "Yol anahtarı.", "key": "name", "value": "" } ] } } }, { "name": "DELETE /v1/hooks/{hook_id}/secrets/{name}", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks", ":hook_id", "secrets", ":name" ], "raw": "{{baseUrl}}/hooks/:hook_id/secrets/:name", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "hook_id", "value": "" }, { "description": "Yol anahtarı.", "key": "name", "value": "" } ] } } }, { "name": "POST /v1/hooks/{hook_id}/versions", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks", ":hook_id", "versions" ], "raw": "{{baseUrl}}/hooks/:hook_id/versions", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "hook_id", "value": "" } ] } } }, { "name": "POST /v1/hooks/{hook_id}/versions/{version}:deploy", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks", ":hook_id", "versions", "{{version}}:deploy" ], "raw": "{{baseUrl}}/hooks/:hook_id/versions/{{version}}:deploy", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "hook_id", "value": "" } ] } } }, { "name": "POST /v1/hooks/{hook_id}:rotate-secret", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks", "{{hook_id}}:rotate-secret" ], "raw": "{{baseUrl}}/hooks/{{hook_id}}:rotate-secret" } } }, { "name": "POST /v1/hooks/{hook_id}:test", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks", "{{hook_id}}:test" ], "raw": "{{baseUrl}}/hooks/{{hook_id}}:test" } } }, { "name": "POST /v1/hooks:pause-code-runtime", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks:pause-code-runtime" ], "raw": "{{baseUrl}}/hooks:pause-code-runtime" } } }, { "name": "POST /v1/hooks:reorder", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "hooks:reorder" ], "raw": "{{baseUrl}}/hooks:reorder" } } } ], "name": "hooks" }, { "description": "`/v1/identity-settings` kaynak ailesi.", "item": [ { "name": "GET /v1/identity-settings", "request": { "description": "Ortamın kullanıcı adı ve doğrulama ayarlarını döndürür (ortam başına tekil kaynak). Ayar hiç yazılmadıysa tablo\nvarsayılanları (`username_identifier: off`, 3–64 karakter, boş ayrılmış liste, `verification_policy:\nbefore_sign_in`, `unverified_account_ttl_days: 7`) ve `ETag: \"0\"` döner; `updated_at` null'dır. Yanıt `ETag`\nbaşlığı taşır (`PATCH` için `If-Match`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "identity-settings" ], "raw": "{{baseUrl}}/identity-settings" } } }, { "name": "PATCH /v1/identity-settings", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortamın kullanıcı adı ve doğrulama ayarlarını RFC 7396 birleştirme yamasıyla günceller (`application/merge-patch+json`).\n`If-Match` zorunludur (yoksa `428`, eşleşmezse `412`); ayar hiç yazılmadıysa sürüm `\"0\"`'dır ve ilk yazma satırı\naçar. `reserved_usernames` için `null` listeyi temizler; öbür alanlar `null` olamaz (`422`, kod `invalid`).\nDeğişiklik içermeyen yama yazma yapmaz ve sürümü artırmaz. Ayar yalnız sonraki yazmalara uygulanır, var olan\nkullanıcılar değişmez: `off` iken kullanıcı adı yazan istekler `422 identifier_type_disabled`, ayrılmış ad\n`422 username_reserved`, uzunluk sınırı dışı `422 invalid` verir; `required` yalnız yönetim API'si ile\nkullanıcı oluşturmada kullanıcı adını zorunlu kılar. Giriş, `off` ortamda kullanıcı adıyla çözülmez.\n`verification_policy` ve `unverified_account_ttl_days` doğrulanmamış hesap temizliğini yönetir: `before_sign_in` ortamında kayıtla oluşturulan, hiçbir e-posta ya da telefonu doğrulanmamış ve hiç\ntoken almamış kullanıcı `unverified_account_ttl_days` (1–30) gün sonra sert silinir (mezar taşı nedeni\n`unverified_expired`, `user.deleted` olayı); `after_sign_in` temizliği durdurur. Kapsam dışı değer\n`422 invalid` (işaretçi `/verification_policy` ya da `/unverified_account_ttl_days`) verir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "identity-settings" ], "raw": "{{baseUrl}}/identity-settings" } } } ], "name": "identity-settings" }, { "description": "`/v1/invitations` kaynak ailesi.", "item": [ { "name": "GET /v1/invitations", "request": { "description": "Ortamın davetlerini kimlik sırasıyla (eskiden yeniye) imleçli listeler; yalnız ileri sayfalama vardır. Süzgeçler:\n`organization_id`, `email` (tam eşleşme), `status`. İmleç süzgeçlere bağlıdır (e-posta özete ortam anahtarlı HMAC ile\ngirer). Kabul bağlantısı listede yoktur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "invitations" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Yalnız bu org'un davetleri (`org_…`).", "disabled": true, "key": "organization_id", "value": "" }, { "description": "Davet e-postası (tam eşleşme, büyük/küçük harf duyarsız).", "disabled": true, "key": "email", "value": "" }, { "description": "Davet durumu süzgeci.", "disabled": true, "key": "status", "value": "" } ], "raw": "{{baseUrl}}/invitations" } } }, { "name": "POST /v1/invitations", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Org'a (`organization_id`) e-posta adresine bağlı davet oluşturur. `organization_id` verilmezse davet ortam\ndavetidir: yalnız davetle kayıt (`invite_only`) kipinde kayıt bağlantısıdır, üyelik açmaz, rol\ntaşıyamaz (`role_ids` `422 validation_failed` `/role_ids` `invalid_value`); yanıtta `organization_id: null`'dır.\nTeslim (`delivery`, zorunlu): `email` davet e-postasını ortamın davet şablonuyla gönderir (`delivery_status: queued`),\nbağlantı yalnız e-postadadır ve yanıtta `accept_url` yoktur; davet e-postası bağlı değilse (yalnız üretim dışı ortam\nkurulumu) `501 not_implemented` döner ve davet yazılmaz. `link_only` e-posta göndermez; kabul bağlantısı (`accept_url`) YALNIZ bu yanıtta, bir\nkez döner ve sonradan hiçbir uçtan okunamaz.\n`role_ids` boşsa org'un varsayılan üye rolü kabulde atanır; `ttl_days` 1–30; verilmezse ortamın `invitation_ttl_days` değeri (varsayılan 7). Aynı org ve e-posta için aynı\nrollerle bekleyen davet varsa yeni davet açılmaz, mevcut davet yeni bağlantıyla yeniden gönderilir ve yanıt `200`'dür\n(≥ 10 dk aralık, en çok 5 gönderim; aksi `429 invite_rate_limited`); farklı rollerle bekleyen davet `409\ninvitation_already_pending`. E-posta zaten üyeyse `409 membership_already_exists`; org devre dışıysa `409\norganization_disabled`; org ya da `application_id` bu ortamda yoksa `404 not_found`. Süresi geçmiş ama henüz işlenmemiş\nbekleyen davet aynı istekte `expired` olur ve yeni davet yazılır (`invitation.expired` audit'i). Aynı rollerle bekleyen\n`email` daveti kendi teslimiyle yeniden gönderilir: yanıt `200`, `delivery: email` ve `accept_url`'sizdir. Toplu oluşturma `POST /v1/invitations:batch`'tir. Yazma `invitation.created` audit'idir.\nAyrıcalıklı (`is_privileged`) rolle davet `invitations:write`'a ek olarak `roles:write` ister; yoksa `403 insufficient_permissions` (`required_permissions`: iki izin) ve davet yazılmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "invitations" ], "raw": "{{baseUrl}}/invitations" } } }, { "name": "GET /v1/invitations/{invitation_id}", "request": { "description": "Daveti döndürür (`inv_…`); kabul bağlantısı yoktur. Davet yoksa ya da başka ortamdaysa `404`. İptal edilen ya da\nsüresi dolan davette `email` null'dır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "invitations", ":invitation_id" ], "raw": "{{baseUrl}}/invitations/:invitation_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "invitation_id", "value": "" } ] } } }, { "name": "POST /v1/invitations/{invitation_id}:resend", "request": { "description": "Bekleyen daveti yeni belirteçle yeniden gönderir: eski bağlantı geçersizleşir. `link_only` davette yeni `accept_url` YALNIZ\nbu yanıtta döner (`Cache-Control: no-store`; tekrar oynatılan yanıt bağlantısız, `secret_redacted: true`); `email` davette\nyeni bağlantı yalnız e-postayla gider ve yanıtta `accept_url` yoktur. Gövde yoktur.\nGönderimler arası en az 10 dk, en çok 5 gönderim (`429 invite_rate_limited`); `expires_at` uzamaz. Bekleyen olmayan davet\n`409 conflict`; davet e-postası bağlı değilse `email` teslimli davet `501 not_implemented`. Yazma `invitation.resent` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "invitations", "{{invitation_id}}:resend" ], "raw": "{{baseUrl}}/invitations/{{invitation_id}}:resend" } } }, { "name": "POST /v1/invitations/{invitation_id}:revoke", "request": { "description": "Bekleyen daveti iptal eder; bağlantı geçersizleşir ve e-posta silinir. Gövde yoktur. Bekleyen olmayan davet `409\nconflict`. Yazma `invitation.revoked` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "invitations", "{{invitation_id}}:revoke" ], "raw": "{{baseUrl}}/invitations/{{invitation_id}}:revoke" } } }, { "name": "POST /v1/invitations:batch", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "1–100 davet oluşturur. Her öğe `POST /v1/invitations` ile aynı kurallardadır ve ayrı yazılır; bir\nöğenin hatası diğerlerini durdurmaz. Yanıt `200`'dür ve `items` istek sırasındadır: öğe `status` `201` (yeni davet), `200`\n(bekleyen davet yeniden gönderildi) ya da hatanın HTTP durumudur; hatalı öğe `error` taşır (`code`, `status`, alan\nişaretçileri `/items//…`). `link_only` öğelerin `accept_url`'i YALNIZ bu yanıtta döner (`Cache-Control: no-store`);\n`Idempotency-Key` ile tekrar oynatılan yanıt bağlantı içermez ve `secret_redacted: true` döner. `organization_id`'siz öğe\nortam davetidir. `email` teslimli öğe davet e-postasıyla gider, davet e-postası bağlı değilse `501 not_implemented`\nöğe hatasıdır; bu ortamda olmayan `application_id` `404 not_found` öğe hatasıdır. Boş ya da 100'den uzun `items` `422`'dir. Her yazılan davet `invitation.created`\naudit'idir.\nAyrıcalıklı (`is_privileged`) rollü öğe kimlik bilgisi `roles:write` taşımıyorsa `403 insufficient_permissions` öğe hatasıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "invitations:batch" ], "raw": "{{baseUrl}}/invitations:batch" } } } ], "name": "invitations" }, { "description": "`/v1/jobs` kaynak ailesi.", "item": [ { "name": "POST /v1/jobs/consent-imports", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Başka sistemden alınmış hukuki metin kabullerini toplu yazar. Eşzamanlıdır: 1–500 kayıt tek işlemde ya hepsiyle yazılır ya hiç yazılmaz. Her kayıt `method = import` taşır ve `occurred_at` kaynak sistemdeki an olarak korunur (zorunlu, gelecekte olamaz). Sürüm, içerik özeti ve dil belgeden alınır. Bir kaydın hatası `422 validation_failed`, işaretçi `/records//`: bilinmeyen kullanıcı `unknown_user`, uygulama `unknown_application`, belge `unknown_subject`. `Idempotency-Key` zorunludur; aynı anahtarla yeniden deneme aynı yanıtı döner ve ikinci kez yazmaz. Plan kapısı yoktur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Bu işlemde zorunlu; yoksa 400 malformed_request.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "consent-imports" ], "raw": "{{baseUrl}}/jobs/consent-imports" } } }, { "name": "POST /v1/jobs/password-resets", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Toplu zorunlu parola sıfırlama işi oluşturur. Kullanıcılar ya `user_ids` ile (1–100.000 `usr_…`; tekrarlar bir kez sayılır) ya da `hash_algos` ile (parolası bu algoritmalarla saklanan ve işten önce değişmiş kullanıcılar) seçilir; ikisi birlikte verilemez. `connection_id` filtresi henüz desteklenmez ve `422` `not_supported` döner. Kip `on_login`: seçilen parolalar sonraki başarılı girişte zorunlu sıfırlamaya düşer. Kip `lazy_then_bulk_reset`: son tarihe kadar (`deadline_days` 1–365, varsayılan 30) girişte zorunlu sıfırlama; son tarihte hâlâ dönüşmemiş kullanıcıların parola özeti silinir ve sıfırlama e-postası doğrulanmış birincil adrese gönderilir. `deadline_days` yalnız bu kipte verilir. İş yanıttan sonra arka planda işaretlenir; durum ve sayaçlar `GET /v1/jobs/password-resets/{job_id}` ile izlenir. Bu ortamda bulunmayan ya da parolası olmayan kullanıcı `not_found` sayılır. Ortamda tamamlanmamış 20 iş varken yeni iş `409` döner. `Idempotency-Key` zorunludur: aynı kimlik bilgisi, aynı anahtar ve aynı istek aynı işi döndürür (`Idempotent-Replayed: true`); aynı anahtar başka bir istekle `422` `idempotency_key_reuse` döner. Yönetim audit'ine `password_reset_job.created` yazılır ve müşteri olayı `password_reset.scheduled` üretilir. `user-credentials:write` izni gerekir; pano kullanıcısı için adım yükseltme ister.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Bu işlemde zorunlu; yoksa 400 malformed_request.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "password-resets" ], "raw": "{{baseUrl}}/jobs/password-resets" } } }, { "name": "GET /v1/jobs/password-resets/{job_id}", "request": { "description": "Toplu zorunlu parola sıfırlama işinin durumunu ve sayaçlarını döndürür. Durum `marking` (işaretleniyor), `waiting` (`lazy_then_bulk_reset` son tarihi bekleniyor), `resetting` (son tarih adımı yürüyor) ya da `completed`'dır. Kişisel veri dönmez. Başka ortamın ya da var olmayan iş `404` döner. `user-credentials:write` izni gerekir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "password-resets", ":job_id" ], "raw": "{{baseUrl}}/jobs/password-resets/:job_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "job_id", "value": "" } ] } } }, { "name": "POST /v1/jobs/user-deletions", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bu ortamın kullanıcılarını toplu silen bir iş oluşturur. Kullanıcılar ya `user_ids` (1–10.000 `usr_…`, tekrarlar bir kez sayılır) ya da `organization_id` (org'un etkin ve askıdaki üyeleri, iş oluşturulurken alınır; 10.000'den fazla üye `422`) ile seçilir; ikisi birlikte verilemez. Önce `dry_run: true` ile çağrılır: hiçbir şey yazılmaz ve `200` ile bu ortamda bulunan kullanıcı sayısı (`matched_count`) döner. Gerçek istek `confirm_count` taşır ve bu sayı o anki `matched_count`'a eşit olmalıdır; değilse `409` `confirmation_mismatch` döner ve iş oluşturulmaz. İş oluşturulunca `202` ile iş nesnesi döner; her kullanıcı `DELETE /v1/users/{user_id}` ile aynı silme yolundan geçer (silme kaydının `initiated_via` değeri `bulk_job`): kullanıcı hemen `pending_deletion` olur, kalıcı silme ve bağlı verilerin temizliği aynı takvimle yapılır. Bu ortamda bulunmayan (başka ortamın ya da var olmayan) kullanıcı silinmez, sonucu `not_found` olur. Ortamda aynı anda tek iş koşar; koşan iş varken yeni iş `429` `rate_limited` ve `Retry-After` döner. `Idempotency-Key` zorunludur: aynı anahtar ve aynı istek aynı işi döndürür, aynı anahtar başka bir istekle `422` `idempotency_key_reuse` döner. Hem `users:delete` hem `jobs:write` izni gerekir. Yönetim audit'ine `user_deletion_job.created` ve `user_deletion_job.completed`, her kullanıcı için `user.deletion_scheduled` (meta veride `job_id`) yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Bu işlemde zorunlu; yoksa 400 malformed_request.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-deletions" ], "raw": "{{baseUrl}}/jobs/user-deletions" } } }, { "name": "GET /v1/jobs/user-deletions/{job_id}", "request": { "description": "Toplu kullanıcı silme işinin durumunu ve sayaçlarını döndürür. Durum `running`, `completed` ya da `completed_with_errors`'tır (en az bir kullanıcı `failed`). Başka ortamın ya da var olmayan iş `404` döner. `users:delete` izni gerekir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-deletions", ":job_id" ], "raw": "{{baseUrl}}/jobs/user-deletions/:job_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "job_id", "value": "" } ] } } }, { "name": "GET /v1/jobs/user-deletions/{job_id}/results", "request": { "description": "İşin kullanıcı başına sonuçlarını istek sırasıyla (eskiden yeniye tek yön) döndürür: `succeeded` (silme isteği yazıldı; `deletion_id` `DELETE /v1/users/{user_id}` yanıtındaki kimliktir), `not_found` (kullanıcı bu ortamda yok), `failed` (yeniden denemelere rağmen silinemedi; `error_code` = `internal`) ya da `pending`. Kişisel veri dönmez. Yalnız `after` imleci desteklenir; `before` ve `order` `422` döner. `users:delete` izni gerekir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-deletions", ":job_id", "results" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/jobs/user-deletions/:job_id/results", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "job_id", "value": "" } ] } } }, { "name": "POST /v1/jobs/user-exports", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Bu işlemde zorunlu; yoksa 400 malformed_request.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-exports" ], "raw": "{{baseUrl}}/jobs/user-exports" } } }, { "name": "GET /v1/jobs/user-exports/{job_id}", "request": { "description": "Kullanıcı verisi dışa aktarma işinin durumunu döndürür. Durum `queued`, `running`, `completed`, `failed` ya da `expired`'dır; `file` yalnız `completed` ve `expired` işlerde dolar, `failure_reason` yalnız `failed` işte (`too_large`, `user_deleted`, `source_unavailable`, `attempts_exhausted`). Son kullanıcının hesap portalından istediği dışa aktarmalar bu uçta görünmez. Başka ortamın ya da var olmayan iş `404` döner. `users:export` izni gerekir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-exports", ":job_id" ], "raw": "{{baseUrl}}/jobs/user-exports/:job_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "job_id", "value": "" } ] } } }, { "name": "GET /v1/jobs/user-exports/{job_id}/download", "request": { "description": "Tamamlanmış kullanıcı dışa aktarma işinin paketine tek kullanımlık indirme bağlantısı verir: `302`, `Location` 15 dakika geçerli, tek kullanımlık belirteç taşıyan `api` indirme adresidir (dosya ortam DEK'iyle şifreli olduğundan nesne deposunun ön imzalı URL'si verilmez). Hedef `/v1` dışındadır ve kimlik bilgisi istemez: belirteç tek kimlik bilgisidir, ilk açılışta harcanır (aktarım yarıda kalsa da) ve `Location` gizli tutulmalıdır. Hedef `200` ile `application/zip` gövdesi (`Content-Disposition: attachment; filename=\"user-export-job_….zip\"`, `Referrer-Policy: no-referrer`, `Cache-Control: no-store`) döner; belirteç geçersiz, kullanılmış ya da süresi dolmuşsa `404 not_found`, `HEAD` `405`. Her bağlantı verilmeden önce yönetim audit'ine `user_export.downloaded` kaydı yazılır. `include_ip` ile oluşturulmuş işin dosyası `audit-events:read_ip` izni de ister (yoksa `403 insufficient_permissions`). İş tamamlanmamışsa ya da dosyanın süresi dolmuşsa `409 conflict`, iş yoksa `404 not_found` döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-exports", ":job_id", "download" ], "raw": "{{baseUrl}}/jobs/user-exports/:job_id/download", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "job_id", "value": "" } ] } } }, { "name": "POST /v1/jobs/user-imports", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Bu işlemde zorunlu; yoksa 400 malformed_request.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-imports" ], "raw": "{{baseUrl}}/jobs/user-imports" } } }, { "name": "GET /v1/jobs/user-imports/{job_id}", "request": { "description": "İskelet işlem; davranış plan satırındadır. Not: izin satırda yazılmamış", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-imports", ":job_id" ], "raw": "{{baseUrl}}/jobs/user-imports/:job_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "job_id", "value": "" } ] } } }, { "name": "GET /v1/jobs/user-imports/{job_id}/errors", "request": { "description": "İskelet işlem; davranış plan satırındadır. Not: izin satırda yazılmamış", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-imports", ":job_id", "errors" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/jobs/user-imports/:job_id/errors", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "job_id", "value": "" } ] } } }, { "name": "PUT /v1/jobs/user-imports/{job_id}/file", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: izin satırda yazılmamış", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-imports", ":job_id", "file" ], "raw": "{{baseUrl}}/jobs/user-imports/:job_id/file", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "job_id", "value": "" } ] } } }, { "name": "POST /v1/jobs/user-imports/{job_id}:cancel", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: izin satırda yazılmamış", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-imports", "{{job_id}}:cancel" ], "raw": "{{baseUrl}}/jobs/user-imports/{{job_id}}:cancel" } } }, { "name": "POST /v1/jobs/user-imports/{job_id}:start", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: izin satırda yazılmamış", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "jobs", "user-imports", "{{job_id}}:start" ], "raw": "{{baseUrl}}/jobs/user-imports/{{job_id}}:start" } } } ], "name": "jobs" }, { "description": "`/v1/legal-documents` kaynak ailesi.", "item": [ { "name": "GET /v1/legal-documents", "request": { "description": "Ortamın yayımlanmış hukuki belgelerini imleçli listeler; sıralama her zaman yeniden eskiye (yayın sırası), yalnız\nileri sayfalama (`after`) vardır. Süzgeçler `kind` ve `application_id`'dir (`application_id` verilince yalnız o\nuygulamaya özel belgeler döner; verilmezse ortam geneli ve uygulamaya özel hepsi).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "legal-documents" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Belge türü süzgeci.", "disabled": true, "key": "kind", "value": "" }, { "description": "Yalnız bu uygulamaya özel belgeler (`app_` önekli dış kimlik).", "disabled": true, "key": "application_id", "value": "" } ], "raw": "{{baseUrl}}/legal-documents" } } }, { "name": "POST /v1/legal-documents", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Müşterinin son kullanıcılarına sunduğu bir hukuki belge sürümünü yayımlar. Platform `url`'yi çıkış\nvekiliyle bir kez çeker ve gövdenin SHA-256 özetini `content_sha256` olarak saklar: yalnız HTTPS, özel ve platform\nadresleri engelli, en çok 5 MiB, 10 sn; 200 dışı yanıt ya da boş gövde çekilemedi sayılır ve `422\nlegal_document_unreachable` döner (belge yazılmaz). Çekme altyapısı bu dağıtımda yapılandırılmamışsa `503`.\n`url`, `version`, `locale` ve özet yayından sonra değişmez; aynı (`application_id`, `kind`, `version`, `locale`)\nikinci kez `409 conflict` verir. `effective_at` verilmezse yayın anıdır; geçmişte olamaz. `locale` ortamın dil\nkaydında olmalıdır; ortamda olmayan `application_id` `422` (kod `unknown_application`) verir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "legal-documents" ], "raw": "{{baseUrl}}/legal-documents" } } }, { "name": "GET /v1/legal-documents/{legal_document_id}", "request": { "description": "Bir hukuki belge sürümünü döndürür. Biçimsiz ya da başka ortamın kimliği `404 not_found` döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "legal-documents", ":legal_document_id" ], "raw": "{{baseUrl}}/legal-documents/:legal_document_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "legal_document_id", "value": "" } ] } } }, { "name": "PATCH /v1/legal-documents/{legal_document_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Belgenin yalnız `requires_reacceptance` ve henüz yürürlüğe girmemiş `effective_at` alanlarını RFC 7396\nbirleştirme yamasıyla değiştirir. Yürürlükteki belgenin `effective_at`'ı değişmez (`422`,\nkod `immutable`); yeni `effective_at` geçmişte olamaz. Öbür alanlar şemada yoktur (`400 unknown_field`); alanlar\n`null` olamaz. Değişiklik içermeyen yama yazma yapmaz ve belgeyi olduğu gibi döner. Belge sürümü (ETag) yoktur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "legal-documents", ":legal_document_id" ], "raw": "{{baseUrl}}/legal-documents/:legal_document_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "legal_document_id", "value": "" } ] } } } ], "name": "legal-documents" }, { "description": "`/v1/log-streams` kaynak ailesi.", "item": [ { "name": "GET /v1/log-streams", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/log-streams" } } }, { "name": "POST /v1/log-streams", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams" ], "raw": "{{baseUrl}}/log-streams" } } }, { "name": "GET /v1/log-streams/{log_stream_id}", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams", ":log_stream_id" ], "raw": "{{baseUrl}}/log-streams/:log_stream_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "log_stream_id", "value": "" } ] } } }, { "name": "DELETE /v1/log-streams/{log_stream_id}", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams", ":log_stream_id" ], "raw": "{{baseUrl}}/log-streams/:log_stream_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "log_stream_id", "value": "" } ] } } }, { "name": "PATCH /v1/log-streams/{log_stream_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams", ":log_stream_id" ], "raw": "{{baseUrl}}/log-streams/:log_stream_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "log_stream_id", "value": "" } ] } } }, { "name": "GET /v1/log-streams/{log_stream_id}/deliveries", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams", ":log_stream_id", "deliveries" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/log-streams/:log_stream_id/deliveries", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "log_stream_id", "value": "" } ] } } }, { "name": "POST /v1/log-streams/{log_stream_id}:pause", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams", "{{log_stream_id}}:pause" ], "raw": "{{baseUrl}}/log-streams/{{log_stream_id}}:pause" } } }, { "name": "POST /v1/log-streams/{log_stream_id}:replay", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams", "{{log_stream_id}}:replay" ], "raw": "{{baseUrl}}/log-streams/{{log_stream_id}}:replay" } } }, { "name": "POST /v1/log-streams/{log_stream_id}:resume", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams", "{{log_stream_id}}:resume" ], "raw": "{{baseUrl}}/log-streams/{{log_stream_id}}:resume" } } }, { "name": "POST /v1/log-streams/{log_stream_id}:rotate-secret", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams", "{{log_stream_id}}:rotate-secret" ], "raw": "{{baseUrl}}/log-streams/{{log_stream_id}}:rotate-secret" } } }, { "name": "POST /v1/log-streams/{log_stream_id}:test", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams", "{{log_stream_id}}:test" ], "raw": "{{baseUrl}}/log-streams/{{log_stream_id}}:test" } } }, { "name": "POST /v1/log-streams/{log_stream_id}:verify", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "log-streams", "{{log_stream_id}}:verify" ], "raw": "{{baseUrl}}/log-streams/{{log_stream_id}}:verify" } } } ], "name": "log-streams" }, { "description": "`/v1/logs` kaynak ailesi.", "item": [ { "name": "GET /v1/logs", "request": { "description": "Ortam loglarını (kimlik doğrulama, oturum, token, MFA, saldırı koruması… kayıtları) süzgeçle imleçli listeler; sıralama her zaman `occurred_at` azalandır (yeniden eskiye), `order` parametresi yoktur. Saklama penceresi ortamın planından sunucuda uygulanır; pencere dışı `from` `400 range_outside_retention` döner. `type` önek eşleşmesidir ve en çok 20 kez verilir. Sorgulama kehaneti olmaması için `ip` süzgeci `audit-events:read_ip`, `q` süzgeci `users:read_pii` izni ister; izin yoksa istek `403 insufficient_permissions` ile reddedilir. Toplam sayı döndürülmez. Görünürlük: `ip`, `ip_asn`, `user_agent` ve `user_agent_family` yalnız kimlik bilgisi `audit-events:read_ip` iznini taşıyorsa, `identifier_hint` yalnız `users:read_pii` iznini taşıyorsa yanıtta bulunur; izin yoksa alan hiç yazılmaz (maskeli değer dönmez). `ip_country` her zaman döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "logs" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "description": "Dahil alt sınır (RFC 3339). Yoksa saklama penceresinin başı; pencere dışı değer `400 range_outside_retention` döner.", "disabled": true, "key": "from", "value": "" }, { "description": "Hariç üst sınır (RFC 3339). Yoksa şimdi; `from` verilmişse ondan sonra olmalıdır.", "disabled": true, "key": "to", "value": "" }, { "description": "Log türü önekleri (`authentication.`, `session.created` gibi); parametre tekrarlanarak en çok 20 değer verilir, değerlerden birine uyan kayıtlar döner.", "disabled": true, "key": "type", "value": "" }, { "description": "Kaydın sonucu.", "disabled": true, "key": "outcome", "value": "" }, { "description": "Kullanıcı (`usr_` önekli dış kimlik).", "disabled": true, "key": "user_id", "value": "" }, { "description": "Organizasyon (`org_` önekli dış kimlik).", "disabled": true, "key": "org_id", "value": "" }, { "description": "Uygulama (`app_` önekli dış kimlik).", "disabled": true, "key": "application_id", "value": "" }, { "description": "Bağlantı (`conn_` önekli dış kimlik).", "disabled": true, "key": "connection_id", "value": "" }, { "description": "Dizin (`dir_` önekli dış kimlik).", "disabled": true, "key": "directory_id", "value": "" }, { "description": "Oturum (`ses_` önekli dış kimlik).", "disabled": true, "key": "session_id", "value": "" }, { "description": "İsteğin `Idp-Request-Id` değeri (UUID); hata ekranındaki kimlikle doğrudan arama.", "disabled": true, "key": "request_id", "value": "" }, { "description": "İş akışının `Idp-Correlation-Id` değeri (UUID).", "disabled": true, "key": "correlation_id", "value": "" }, { "description": "Tam IP adresi ya da CIDR bloğu (`203.0.113.0/24`, `2001:db8::/32`). `audit-events:read_ip` izni ister; izin yoksa `403 insufficient_permissions`.", "disabled": true, "key": "ip", "value": "" }, { "description": "IP'nin ülkesi (ISO 3166-1 alpha-2, büyük harf).", "disabled": true, "key": "ip_country", "value": "" }, { "description": "Girilen tanımlayıcının maskeli ipucunda (`identifier_hint`) önek araması. `users:read_pii` izni ister; izin yoksa `403 insufficient_permissions`.", "disabled": true, "key": "q", "value": "" } ], "raw": "{{baseUrl}}/logs" } } }, { "name": "GET /v1/logs/{log_id}", "request": { "description": "Tek ortam logu kaydını `details` dahil döner. Kayıt yoksa, başka ortamınsa ya da saklama penceresi dışındaysa `404 not_found` döner. Görünürlük: `ip`, `ip_asn`, `user_agent` ve `user_agent_family` yalnız kimlik bilgisi `audit-events:read_ip` iznini taşıyorsa, `identifier_hint` yalnız `users:read_pii` iznini taşıyorsa yanıtta bulunur; izin yoksa alan hiç yazılmaz (maskeli değer dönmez). `ip_country` her zaman döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "logs", ":log_id" ], "raw": "{{baseUrl}}/logs/:log_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "log_id", "value": "" } ] } } } ], "name": "logs" }, { "description": "`/v1/management-clients` kaynak ailesi.", "item": [ { "name": "GET /v1/management-clients", "request": { "description": "Ortamdaki yönetim M2M istemci kayıtlarını imleçli olarak listeler; sıra `application_id`'dir (varsayılan azalan, `order=asc` ile artan). Kayıt bir `management` uygulamasının yönetim API'sindeki izin tavanı ve IP izin listesidir; imza anahtarları bu kaynakta yoktur. Yalnız API anahtarıyla çağrılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "management-clients" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/management-clients" } } }, { "name": "POST /v1/management-clients", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Bir `management` türündeki uygulamaya (`app_…`) yönetim istemcisi kaydı ekler. `permissions` bilinen `:` izinleridir (boş olamaz, en çok 200; bilinmeyen izin 422). `allowed_cidrs` (en çok 20) geçerli CIDR'dir; verilmezse çağıran anahtarın listesi kullanılır. Uygulama bu ortamda yoksa (başka ortamınki dahil) 404, türü `management` değilse 422 (`/application_id`), kaydı zaten varsa 409 `conflict`. Kısıtlı anahtar kendi izinlerini ve ağlarını aşan kayıt yazamaz (403 `permission_escalation`). `jwks_uri` ve `public_keys` bu kaynakta yoktur (400 `unknown_field`): imza anahtarları uygulamanın kimlik bilgisi uçlarındadır. Yanıt `ETag` taşır; her yazma yönetim audit kaydına hedefle (`management_client`) girer, içerik girmez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "management-clients" ], "raw": "{{baseUrl}}/management-clients" } } }, { "name": "GET /v1/management-clients/{application_id}", "request": { "description": "Bir uygulamanın yönetim istemcisi kaydını döner; yanıt `ETag` taşır. Kayıt yoksa ya da başka ortamdaysa 404.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "management-clients", ":application_id" ], "raw": "{{baseUrl}}/management-clients/:application_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "DELETE /v1/management-clients/{application_id}", "request": { "description": "Kaydı siler; uygulama silinmez. `If-Match` zorunludur: yoksa `428`, sürüm eşleşmezse `412`. Kayıt yoksa ya da başka ortamdaysa 404. Kısıtlı anahtar kendisinden geniş bir kaydı silemez (403 `permission_escalation`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "management-clients", ":application_id" ], "raw": "{{baseUrl}}/management-clients/:application_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "PATCH /v1/management-clients/{application_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kaydı birleştirme yamasıyla (RFC 7396) günceller. `If-Match` zorunludur: yoksa `428`, sürüm eşleşmezse `412`. Yazılabilir alanlar `permissions` ve `allowed_cidrs`'tir; başka alan `400 unknown_field`. `permissions` null olamaz (422); `allowed_cidrs` null ya da `[]` çağıranın listesini alır. Hiçbir alanı değiştirmeyen yama kaydı, sürümü ve audit kaydını değiştirmez. Kısıtlı anahtar kendisinden geniş bir kaydı değiştiremez (403 `permission_escalation`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "management-clients", ":application_id" ], "raw": "{{baseUrl}}/management-clients/:application_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } } ], "name": "management-clients" }, { "description": "`/v1/org-custom-role-permissions` kaynak ailesi.", "item": [ { "name": "GET /v1/org-custom-role-permissions", "request": { "description": "Ortamın org özel rollerine açtığı izin listesini döndürür. Liste boşken org rolü oluşturulamaz. Okuma plan\nhakkına bağlı değildir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "org-custom-role-permissions" ], "raw": "{{baseUrl}}/org-custom-role-permissions" } } }, { "name": "PUT /v1/org-custom-role-permissions", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortamın org özel rol izin listesini tam küme olarak değiştirir (en çok 1000; `permission_ids`). Listeye izin eklemek\n`org_custom_roles` plan hakkı ister (Business; yoksa `403 plan_feature_unavailable`); listeyi daraltmak her planda\nserbesttir ve listeden çıkan izinler org rollerinden aynı işlemde düşer. Bilinmeyen izin `422 unknown_permission`,\nyasaklı izin `422 permission_not_allowed`. Değişiklik yönetim audit'ine `org_custom_role_permissions.updated` olarak düşer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "org-custom-role-permissions" ], "raw": "{{baseUrl}}/org-custom-role-permissions" } } } ], "name": "org-custom-role-permissions" }, { "description": "`/v1/organization-defaults` kaynak ailesi.", "item": [ { "name": "GET /v1/organization-defaults", "request": { "description": "Ortamın org varsayılanlarını döndürür: org\nyönetici rolü ve yeni üyenin varsayılan rolü, kullanıcı başına üyelik sınırı, davet geçerlilik süresi, self servis org\nsilmenin bekleme süresi, org silinince üyelere ne olacağı (`on_org_delete_members`), org özel rolleri ve org'un kendini\nsilmesi anahtarları. Yanıt `ETag` başlığı taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organization-defaults" ], "raw": "{{baseUrl}}/organization-defaults" } } }, { "name": "PATCH /v1/organization-defaults", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortamın org varsayılanlarını RFC 7396 birleştirme yamasıyla günceller (`application/merge-patch+json`). `If-Match`\nzorunludur (yoksa `428`, eşleşmezse `412`). Hiçbir alan `null` olamaz (`422`, kod `invalid`). Rol alanları ortamın\nrolü olmalıdır (`422 unknown_role`); yeni org yönetici rolü org yönetiminin sistem izinlerini taşımalıdır (`422\npermission_reserved`) ve hiçbir org etkin yöneticisiz kalmamalıdır (`409 last_org_admin`). Aralıklar:\n`max_memberships_per_user` 1–1000, `invitation_ttl_days` 1–30, `org_self_service_deletion_grace_days` 0–30\n(`422 out_of_range`); `on_org_delete_members` `detach` ya da `delete_exclusive_provisioned`'dır.\n`delete_exclusive_provisioned` org silinince yalnız o org'a JIT ya da SCIM ile gelmiş ve başka org üyeliği olmayan\nkullanıcıları silme kuyruğuna alır. Org özel rol yazmaları anahtar açıkken de `org_custom_roles` plan\nhakkına bağlıdır. Değişiklik içermeyen yama yazma yapmaz ve sürümü artırmaz. Değişiklik yönetim audit'ine\n`organization_defaults.updated` olarak değişen alan adlarıyla düşer, değerler yazılmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organization-defaults" ], "raw": "{{baseUrl}}/organization-defaults" } } } ], "name": "organization-defaults" }, { "description": "`/v1/organization-domains` kaynak ailesi.", "item": [ { "name": "GET /v1/organization-domains", "request": { "description": "Ortamın org alan adlarını eskiden yeniye (kimlik sırası) imleçli listeler; yalnız ileri sayfalama (`after`) vardır\n(`before` ve `asc` dışı `order` `422`). Sayfa 1–100 kayıt, varsayılan 20. `organization_id`, `domain` (Unicode ya da\nA-label, tam eşleşme) ve `status` süzgeçtir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organization-domains" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Yalnız bu org'un alanları (`org_…`).", "disabled": true, "key": "organization_id", "value": "" }, { "description": "Tam alan adı (Unicode ya da A-label; sunucu A-label küçük harfe çevirir).", "disabled": true, "key": "domain", "value": "" }, { "description": "Durum süzgeci.", "disabled": true, "key": "status", "value": "" } ], "raw": "{{baseUrl}}/organization-domains" } } }, { "name": "POST /v1/organization-domains", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Org'a alan adı ekler. `domain` Unicode ya da A-label olabilir; küçük harf A-label'a çevrilir. `dns_txt`\n(varsayılan) kayıt `pending` doğar ve yanıttaki TXT kaydı (`txt_record_name` = `_akp-verify.`,\n`txt_record_value` = `idp-verify=`) DNS'e eklenince `:verify` ya da zamanlanmış denetimle doğrulanır; 72 saatte\ndoğrulanmayan kayıt `expired` olur. `manual` yöntemi müşterinin sahiplik beyanıdır, kayıt oluşturulduğu anda\n`verified`'dır ve beyan yönetim audit'ine yazılır. Genel sonek (PSL) ya da ücretsiz e-posta sağlayıcısı `422\ndomain_not_claimable`; alan bu org'da zaten varsa `409 conflict`, başka org'da doğrulanmışsa (manual) `409\ndomain_already_verified`; org'da 100 kayıt varsa `409 domain_limit_reached`; devre dışı ya da silinmeyi bekleyen\norg'da `409 organization_disabled` / `organization_pending_deletion`. Yanıt `ETag` taşır; `Idempotency-Key` isteğe\nbağlıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organization-domains" ], "raw": "{{baseUrl}}/organization-domains" } } }, { "name": "GET /v1/organization-domains/{domain_id}", "request": { "description": "Alan kaydını döndürür; yanıt `ETag` taşır. Kayıt yoksa ya da başka ortamdaysa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organization-domains", ":domain_id" ], "raw": "{{baseUrl}}/organization-domains/:domain_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "domain_id", "value": "" } ] } } }, { "name": "DELETE /v1/organization-domains/{domain_id}", "request": { "description": "Alan kaydını kalıcı siler; capture ve SSO yönlendirmesi kayıtla gider. `If-Match` isteğe bağlıdır; varsa eşleşmeli\n(`412`). Kayıt yoksa `404`. Silme yönetim audit'ine yazılır ve `organization_domain.deleted` olayı yayımlanır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organization-domains", ":domain_id" ], "raw": "{{baseUrl}}/organization-domains/:domain_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "domain_id", "value": "" } ] } } }, { "name": "PATCH /v1/organization-domains/{domain_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Alanın capture ve SSO yönlendirme ayarını birleştirme yamasıyla (RFC 7396) günceller: `capture_mode` (`off`|`suggest`|\n`auto_join`) ve `sso_routing_enabled`; başka alan `400 unknown_field`, null `422`. İkisi de yalnız `verified` kayıtta\naçılır (`409 domain_not_verified`). `If-Match` isteğe bağlıdır; varsa eşleşmeli (`412`). Hiçbir alanı değiştirmeyen\nyama kaydı değiştirmez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organization-domains", ":domain_id" ], "raw": "{{baseUrl}}/organization-domains/:domain_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "domain_id", "value": "" } ] } } }, { "name": "POST /v1/organization-domains/{domain_id}:verify", "request": { "description": "Doğrulamayı hemen çalıştırır; gövde yoktur. `pending` ve `unverified` kayıt DNS'te denetlenir (TXT kaydı bulunursa\n`verified`; değilse kayıt durumunu korur ve `last_failure_code` dolar, yanıt yine `200`'dür). `expired` ve `revoked`\nkayıt yeni token'la `pending`'e döner (yeni TXT değeri). `verified` ve `manual` kayıt değişmeden döner. Alan başka\norg'da doğrulanmışsa kayıt doğrulanmaz (`last_failure_code` = `already_verified`). Denetim eşzamanlı bir yazmayla\nçakışırsa `409 conflict` (yeniden deneyin); devre dışı ya da silinmeyi bekleyen org'da `409\norganization_disabled` / `organization_pending_deletion`; hücre DNS çözücüsü yapılandırılmamışsa `503`. Yanıt `ETag` taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organization-domains", "{{domain_id}}:verify" ], "raw": "{{baseUrl}}/organization-domains/{{domain_id}}:verify" } } } ], "name": "organization-domains" }, { "description": "`/v1/organizations` kaynak ailesi.", "item": [ { "name": "GET /v1/organizations", "request": { "description": "Ortamın org'larını imleçli listeler; sıralama her zaman yeniden eskiye (`created_at`, sonra kimlik), yalnız ileri\nsayfalama (`after`) vardır (`before` ve `desc` dışı `order` `422`). Sayfa 1–100 kayıt, varsayılan 20. `slug`,\n`external_id` ve `status` tam eşleşme süzgeçleridir; eski slug rezervi listede çözülmez. `domain` süzgeci doğrulanmış\nalan adları özelliğiyle gelir; o güne kadar `422 unsupported` döner (sessizce yok sayılmaz). Silinmiş org listede yoktur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Güncel slug ile tam eşleşme (eski slug rezervi çözülmez).", "disabled": true, "key": "slug", "value": "" }, { "description": "`external_id` ile tam eşleşme.", "disabled": true, "key": "external_id", "value": "" }, { "description": "Durum süzgeci.", "disabled": true, "key": "status", "value": "" }, { "description": "Doğrulanmış alan adı süzgeci; alan adları özelliği gelene dek desteklenmez ve `422 unsupported` döner.", "disabled": true, "key": "domain", "value": "" } ], "raw": "{{baseUrl}}/organizations" } } }, { "name": "POST /v1/organizations", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortamda org oluşturur. `name` zorunludur; `slug` verilmezse addan türetilir (çakışırsa `-2` … `-20`\nsonekiyle). Slug ortamda tekildir: kullanımdaysa `409 slug_taken`, ayrılmış sözcükse ya da başka org'un son 90 gündeki eski\nslug'ıysa `409 slug_reserved`. `external_id` ortamda tekildir (`409 external_id_taken`). `metadata` en çok 16 KiB, 5\ndüzey derinlik ve 100 üst düzey anahtarlı JSON nesnesidir ve yalnız bu API'de döner. Yanıt `ETag` taşır.\n`organization.created` olayı yayımlanır ve yönetim audit'ine yazılır. Ortamın org tavanı doluysa `403 quota_exceeded`. `Idempotency-Key` isteğe bağlıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations" ], "raw": "{{baseUrl}}/organizations" } } }, { "name": "GET /v1/organizations/{org_id}", "request": { "description": "Org'u döndürür; yanıt `ETag` taşır. Biçimsiz, bilinmeyen, silinmiş ya da başka ortamın org kimliği `404`'tür.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id" ], "raw": "{{baseUrl}}/organizations/:org_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "DELETE /v1/organizations/{org_id}", "request": { "description": "Org'u anında ve kalıcı olarak siler. Slug 90 gün\nrezerve kalır. `organization.deleted` olayı yayımlanır ve yönetim audit'ine yazılır. Bilinmeyen ya da zaten silinmiş org\n`404`'tür.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id" ], "raw": "{{baseUrl}}/organizations/:org_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "PATCH /v1/organizations/{org_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Org'u birleştirme yamasıyla (RFC 7396) günceller. `If-Match` zorunludur: yoksa `428`, sürüm eşleşmezse `412`. Yazılabilir\nalanlar `name`, `slug`, `external_id`, `metadata`, `brand_color`, `max_memberships` ve `default_zoneinfo`'dur; başka\nalan `400 unknown_field`. `name` ve `slug` temizlenemez (null `422`); `external_id`, `brand_color` ve\n`default_zoneinfo` null ile temizlenir,\n`max_memberships` null sınırsızdır, `metadata` iç içe birleşir ve null `{}` yapar. Slug 30 günde bir değişebilir\n(`409 slug_change_rate_limited`); eski slug 90 gün başka org'a verilmez. Silinmeyi bekleyen org güncellenemez (`409\norganization_pending_deletion`). Hiçbir alanı değiştirmeyen yama kaydı ve sürümü değiştirmez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id" ], "raw": "{{baseUrl}}/organizations/:org_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "GET /v1/organizations/{org_id}/admin-relationships", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "admin-relationships" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/organizations/:org_id/admin-relationships", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}/admin-relationships", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "admin-relationships" ], "raw": "{{baseUrl}}/organizations/:org_id/admin-relationships", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}/admin-relationships/{relationship_id}:approve", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "admin-relationships", "{{relationship_id}}:approve" ], "raw": "{{baseUrl}}/organizations/:org_id/admin-relationships/{{relationship_id}}:approve", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}/admin-relationships/{relationship_id}:terminate", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "admin-relationships", "{{relationship_id}}:terminate" ], "raw": "{{baseUrl}}/organizations/:org_id/admin-relationships/{{relationship_id}}:terminate", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "GET /v1/organizations/{org_id}/app-access", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "app-access" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/organizations/:org_id/app-access", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}/app-access", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "app-access" ], "raw": "{{baseUrl}}/organizations/:org_id/app-access", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "PUT /v1/organizations/{org_id}/app-access/{entry_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "app-access", ":entry_id" ], "raw": "{{baseUrl}}/organizations/:org_id/app-access/:entry_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "entry_id", "value": "" } ] } } }, { "name": "DELETE /v1/organizations/{org_id}/app-access/{entry_id}", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "app-access", ":entry_id" ], "raw": "{{baseUrl}}/organizations/:org_id/app-access/:entry_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "entry_id", "value": "" } ] } } }, { "name": "GET /v1/organizations/{org_id}/applications/{application_id}", "request": { "description": "Uygulamanın org'daki erişim satırını döndürür. Satır hiç yazılmamışsa\n`status` `disabled`, `version` 0 ve zamanlar null'dır (ETag `\"0\"`). Uygulamanın `org_access_mode`'u\n`enabled_organizations` ya da `assigned_only` ise org bağlamlı giriş yalnız `enabled` satırda geçer. Org, uygulama ya da\nortam eşleşmezse `404`. Yanıt `ETag` taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "applications", ":application_id" ], "raw": "{{baseUrl}}/organizations/:org_id/applications/:application_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "PUT /v1/organizations/{org_id}/applications/{application_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Uygulamayı org'da etkinleştirir (`enabled`) ya da devre dışı bırakır (`disabled`). İşlem değer bazında idempotenttir:\naynı durum sürümü değiştirmez. `If-Match` isteğe bağlıdır; verilirse güncel `ETag` ile eşleşmelidir (hiç yazılmamış\nsatırda `\"0\"`), eşleşmezse `412 precondition_failed`; `\"0\"` yalnız satır hâlâ hiç yazılmamışsa yazar, arada başka\nbir istek yazdıysa `412`'dir. Silinmeyi bekleyen org'da etkinleştirme `409\norganization_pending_deletion`'dır (devre dışı bırakma serbesttir).\nDevre dışı bırakmak atamaları silmez; `assigned_only` uygulamada atamalar yeniden etkinleştirmede geçerli olur. Yanıt\n`ETag` taşır; yazma yönetim audit'ine `organization_application.enabled` / `.disabled` olarak düşer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "applications", ":application_id" ], "raw": "{{baseUrl}}/organizations/:org_id/applications/:application_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "GET /v1/organizations/{org_id}/applications/{application_id}/assignments", "request": { "description": "Uygulamanın org'daki atamalarını eskiden yeniye (kimlik sırası) imleçli listeler; yalnız ileri sayfalama (`after`) vardır\n(`before` ve `asc` dışı `order` `422`). Sayfa 1–100 kayıt, varsayılan 20. İmleç org ve uygulamaya bağlıdır; başka yolun\nimleci `422 invalid_cursor`'dır. Tek atama okuma ucu yoktur; atama değişmez, yalnız silinir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "applications", ":application_id", "assignments" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/organizations/:org_id/applications/:application_id/assignments", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}/applications/{application_id}/assignments", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Uygulamaya org içinde bir üyelik (`membership`, `mem_…`) ya da dizin grubu (`directory_group`, `dsg_…`) atar.\n`assigned_only` kipindeki uygulamada org bağlamlı giriş, etkin satıra ek olarak üyeliğin kendisinin ya da dizin\ngrubunun atanmış olmasını ister. Uygulama org'da etkin değilse `409 application_not_enabled`; aynı hedef zaten\natanmışsa `409 conflict`; hedef bu org'da yoksa `404`; silinmeyi bekleyen org'da `409 organization_pending_deletion`.\nDizin grupları SCIM ile gelir; grup silinince atamaları da silinir. Bu sürümde SCIM grupları directory'ye\nyansıtılmadığından `directory_group` hedefi `404`'tür. `Idempotency-Key` isteğe bağlıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "applications", ":application_id", "assignments" ], "raw": "{{baseUrl}}/organizations/:org_id/applications/:application_id/assignments", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" } ] } } }, { "name": "DELETE /v1/organizations/{org_id}/applications/{application_id}/assignments/{assignment_id}", "request": { "description": "Atamayı siler; yanıt gövdesizdir. Atama yoksa ya da başka org, uygulama veya ortamdaysa `404`. Silme yönetim audit'ine\n`application_assignment.deleted` olarak düşer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "applications", ":application_id", "assignments", ":assignment_id" ], "raw": "{{baseUrl}}/organizations/:org_id/applications/:application_id/assignments/:assignment_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "application_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "assignment_id", "value": "" } ] } } }, { "name": "GET /v1/organizations/{org_id}/memberships", "request": { "description": "Org'un üyeliklerini son güncelleme sırasıyla (eskiden yeniye; eşitlikte kimlik) imleçli listeler; yalnız ileri\nsayfalama vardır (`before` ve `asc` dışı `order` `422`). Süzgeçler: `status`, `role_id` (`rol_…`), `updated_after` (RFC\n3339). İmleç org ve süzgeçlere bağlıdır; başka listenin imleci `400 invalid_cursor`'dır. Org bu ortamda yoksa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "memberships" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Üyelik durumu süzgeci.", "disabled": true, "key": "status", "value": "" }, { "description": "Yalnız bu rolü taşıyan üyelikler (`rol_…`).", "disabled": true, "key": "role_id", "value": "" }, { "description": "Yalnız bu andan sonra güncellenen üyelikler (RFC 3339).", "disabled": true, "key": "updated_after", "value": "" } ], "raw": "{{baseUrl}}/organizations/:org_id/memberships", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}/memberships", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kullanıcıyı (`usr_…`) org'a doğrudan üye ekler (kaynak `admin_api`, durum `active`). `role_ids` boşsa org'un varsayılan\nüye rolü atanır; roller ortam rolü ya da bu org'un rolü olmalıdır (`403 role_not_assignable`). `expires_at` verilirse\ngelecekte olmalıdır. Kullanıcı zaten üyeyse `409 membership_already_exists`; anonim kullanıcı `422\nanonymous_user_not_allowed`; etkin olmayan kullanıcı `403 user_not_active`; org devre dışıysa `409\norganization_disabled`; org ya da kullanıcı üyelik sınırı aşılırsa `409 organization_membership_limit_reached` / `409\nmembership_limit_reached`. Yanıt `ETag` taşır; yazma `organization_membership.created` audit'idir. `Idempotency-Key`\nisteğe bağlıdır.\nAyrıcalıklı (`is_privileged`) rol atamak `organizations:write`'a ek olarak `roles:write` ister; yoksa `403 insufficient_permissions` (`required_permissions`: iki izin) ve yazma olmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "memberships" ], "raw": "{{baseUrl}}/organizations/:org_id/memberships", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "GET /v1/organizations/{org_id}/memberships/{membership_id}", "request": { "description": "Üyeliği rolleriyle döndürür (`mem_…`). Üyelik yoksa ya da başka org veya ortamdaysa `404`. Yanıt `ETag` taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "memberships", ":membership_id" ], "raw": "{{baseUrl}}/organizations/:org_id/memberships/:membership_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "membership_id", "value": "" } ] } } }, { "name": "DELETE /v1/organizations/{org_id}/memberships/{membership_id}", "request": { "description": "Üyeliği kaldırır (neden `removed_by_admin`); yanıt gövdesizdir. Org'un son etkin yöneticisi kaldırılamaz. `If-Match` isteğe bağlıdır; verilirse güncel `ETag` ile eşleşmelidir (`412`). Kaldırma yönetim\naudit'ine `organization_membership.deleted` olarak düşer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "memberships", ":membership_id" ], "raw": "{{baseUrl}}/organizations/:org_id/memberships/:membership_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "membership_id", "value": "" } ] } } }, { "name": "PATCH /v1/organizations/{org_id}/memberships/{membership_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Üyeliğin `role_ids` (elle atanmış rollerin tam kümesi) ya da `expires_at` alanını RFC 7396 birleştirme yamasıyla\ndeğiştirir; ikisi aynı istekte de değişebilir ve tek transaction'da uygulanır: ya ikisi birden yazılır ya hiçbiri. `expires_at` gelecekte ve\nüyeliğin oluşturulmasından en çok 365 gün sonra olmalıdır (`422 out_of_range`); `null` bitişi kaldırır; kaldırılmış\nüyelikte `422 invalid_state`. `role_ids: null` etkisizdir. Rol kuralları `PUT …/roles` ile aynıdır (`409 last_org_admin`,\n`403 role_not_assignable`, `422 unknown_role`). Değişmeyen alan yazılmaz. `If-Match` isteğe bağlıdır; verilirse\ngüncel `ETag` ile eşleşmelidir (`412`) ve sürüm yazmaya sabitlenir. Yanıt güncel üyeliği ve `ETag`'i taşır; yazma\n`organization_membership.updated` audit'idir.\n`role_ids` ayrıcalıklı (`is_privileged`) rol içeriyorsa `organizations:write`'a ek olarak `roles:write` gerekir; yoksa `403 insufficient_permissions`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "memberships", ":membership_id" ], "raw": "{{baseUrl}}/organizations/:org_id/memberships/:membership_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "membership_id", "value": "" } ] } } }, { "name": "GET /v1/organizations/{org_id}/memberships/{membership_id}/diagnostics", "request": { "description": "Üye teşhis görünümü: org yöneticisinin \"üye neden giremiyor\" sorusu için tek yanıtta\nüyelik (durum, kaynak, roller, askı nedeni), org katmanındaki politika özeti (MFA, izinli yöntemler, SSO zorlaması,\nIP listesi var/yok; `null` = org o eksende ortam değerini devralır), `invited` üyelikte kullanıcının birincil\ne-postasına bekleyen davet ve teslim durumu, doğrulayıcı özeti (yalnız sınıflar ve MFA kaydı) ve org bağlamındaki giriş\ndurumu (kilit; son giriş yalnız o org'un oturumlarından), üyenin org'un dizinlerindeki grupları ve erişimi kısıtlı\nuygulamalardaki erişim kararı döner. Salt okumadır. Etiket, AAGUID, IP, kullanıcı aracısı,\ne-posta, CIDR ve başka org bağlamındaki kayıt dönmez. Üyelik yoksa, `removed` ise ya da\nbaşka org veya ortamdaysa `404`. Giriş etkinliği `GET /v1/users/{user_id}/logs?org_id=` ile okunur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "memberships", ":membership_id", "diagnostics" ], "raw": "{{baseUrl}}/organizations/:org_id/memberships/:membership_id/diagnostics", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "membership_id", "value": "" } ] } } }, { "name": "PUT /v1/organizations/{org_id}/memberships/{membership_id}/roles", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Üyeliğin elle atanmış rollerini tam küme olarak değiştirir (`role_ids`; boş dizi elle atanmış rolleri kaldırır).\nEşleme ve dizin kaynaklı roller bu işlemle değişmez. `role_version` verilirse üyeliğin güncel `version`'ı olmalıdır;\nuyuşmazlıkta `409 conflict`. Son yöneticinin yönetici rolü düşürülemez (`409 last_org_admin`); atanamayan rol\n`403 role_not_assignable`. Yanıt güncel üyeliği ve `ETag`'i taşır; yazma `organization_membership.updated` audit'idir.\nKümede ayrıcalıklı (`is_privileged`) rol varsa `organizations:write`'a ek olarak `roles:write` gerekir; yoksa `403 insufficient_permissions` (`required_permissions`: iki izin) ve yazma olmaz.\n`revoke_sessions` (varsayılan `true`): bu sürümde seçim yalnız `organization_membership.updated` audit'inin `revoke_sessions` meta verisine kaydedilir, oturum iptal edilmez. Ayrıcalıklı rol kaldırıldığında kullanıcının bu org bağlamındaki refresh ailelerinin iptali authn tarafında planlıdır (`planned`); `false` o iptali kapatacak seçimdir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "memberships", ":membership_id", "roles" ], "raw": "{{baseUrl}}/organizations/:org_id/memberships/:membership_id/roles", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "membership_id", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}/memberships/{membership_id}:reactivate", "request": { "description": "Askıdaki üyeliği yeniden etkinleştirir; org ve kullanıcı etkin olmalıdır. Askıda olmayan üyelik `422 invalid_state`\n(etkin üyelikte değişiklik yazılmaz). Gövde yoktur. `If-Match` isteğe bağlıdır (`412`). Yanıt güncel üyeliği ve `ETag`'i\ntaşır; yazma `organization_membership.updated` (`change=reactivated`) audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "memberships", "{{membership_id}}:reactivate" ], "raw": "{{baseUrl}}/organizations/:org_id/memberships/{{membership_id}}:reactivate", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}/memberships/{membership_id}:suspend", "request": { "description": "Etkin üyeliği askıya alır (neden `admin_suspended`); askıdaki üye org bağlamında giriş yapamaz ve org\nbağlamlı oturumları kapanır. Org'un son etkin yöneticisi askıya alınamaz; davetli ya da\nkaldırılmış üyelik `422 invalid_state`; zaten askıdaysa değişiklik yazılmaz. Gövde yoktur. `If-Match` isteğe bağlıdır (`412`). Yanıt\ngüncel üyeliği ve `ETag`'i taşır; yazma `organization_membership.updated` (`change=suspended`) audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "memberships", "{{membership_id}}:suspend" ], "raw": "{{baseUrl}}/organizations/:org_id/memberships/{{membership_id}}:suspend", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "GET /v1/organizations/{org_id}/policies", "request": { "description": "Org'un yazılmış kimlik politikalarını tür sırasıyla listeler. Yazılmamış tür ortamın değerini devralır ve listede yoktur. En çok\naltı öğe olduğundan sayfalanmaz; zarf standart liste biçimindedir, `list_metadata` imleçleri null'dır. Org yoksa ya da başka\nortamdaysa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "policies" ], "raw": "{{baseUrl}}/organizations/:org_id/policies", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "GET /v1/organizations/{org_id}/policies/{policy_kind}", "request": { "description": "Org'un bir türdeki politikasını döndürür; yanıt `ETag` taşır. Tür için politika yazılmamışsa `404` (org o eksende\nortamın değerini devralır); bilinmeyen tür de `404`'tür.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "policies", ":policy_kind" ], "raw": "{{baseUrl}}/organizations/:org_id/policies/:policy_kind", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Org politikası türü; bilinmeyen tür `404`.", "key": "policy_kind", "value": "" } ] } } }, { "name": "PUT /v1/organizations/{org_id}/policies/{policy_kind}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Türün ayar nesnesini tam olarak değiştirir. Politika zaten varsa `If-Match` zorunludur: yoksa `428`, sürüm\neşleşmezse `412` (`*` mevcut politikayla eşleşir). Politika yoksa başlıksız istek onu oluşturur (`201`); başlıklı\nistek `412`'dir. Oluşturma yarışsızdır: aynı türü\neşzamanlı oluşturan ikinci istek `412` alır ve ilk yazı korunur. Ayar alanları türe göre:\n`authentication_methods` → `allowed_connection_ids` (`conn_…`), `allow_passkey`, `allow_password`; `mfa` →\n`required_for` (`none`|`admins`|`all`), `allowed_factors` (`totp`, `webauthn`, `sms`, `email`), `enrollment_grace_days`\n(0–30); `phishing_resistant` → `required_for`, `aaguid_allowlist` (≤ 500); `sso_enforcement` → `mode` (`off`|\n`org_context`|`verified_domains`), `connection_ids` (`conn_…`), `bypass_user_ids` (`usr_…`, ≤ 2); `session` →\n`idle_minutes`, `absolute_minutes`, `refresh_idle_days`, `refresh_absolute_days` (verilmeyen ortamdan); `ip_allowlist`\n→ `cidrs` (≤ 100, maskeli kanonik biçim), `applies_to` (`admins`|`all`). Bilinmeyen alan ya da geçersiz değer `422\nvalidation_failed` (`errors[]` işaretçisi `/settings/…`). Ayar ortamın ayarından gevşekse `422\npolicy_weaker_than_parent` (`errors[]` gevşek alanı gösterir); `authentication_methods` hiçbir yöntem bırakmıyorsa\n`422 at_least_one_method`; `authentication_methods` ya da açık `sso_enforcement`, org bağlamında kullanılabilen bir\nuygulama ve ortamla ortak birinci faktör bırakmıyorsa `422 policy_conflict`;\n`verified_domains` kipi org'da doğrulanmış alan ister (`409 domain_not_verified`); `sso_enforcement`'ı açmak\n(`off`'tan ya da politika yokken) `connection_ids`'den en az birinin güncel yapılandırmasının son 24 saatte başarılı\ntest girişini ister;\nsilinmeyi bekleyen org'da `409 organization_pending_deletion`. Plan kapısı sunucudadır: `session` ve `ip_allowlist`\ntürleri ile AAGUID listesi Enterprise ister (`403 plan_feature_unavailable`, `feature` ve `required_plan` ile; geliştirme\nortamında açıktır). Ayar içeriği yönetim audit'ine yazılır; `organization.updated` olayı içerik taşımaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "policies", ":policy_kind" ], "raw": "{{baseUrl}}/organizations/:org_id/policies/:policy_kind", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Org politikası türü; bilinmeyen tür `404`.", "key": "policy_kind", "value": "" } ] } } }, { "name": "DELETE /v1/organizations/{org_id}/policies/{policy_kind}", "request": { "description": "Politikayı siler; org o eksende ortamın değerine döner. `If-Match` zorunludur: yoksa `428`, sürüm eşleşmezse `412`.\nPolitika yoksa `404`. Silme yönetim audit'ine yazılır ve `organization.updated` olayı yayımlanır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "policies", ":policy_kind" ], "raw": "{{baseUrl}}/organizations/:org_id/policies/:policy_kind", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Org politikası türü; bilinmeyen tür `404`.", "key": "policy_kind", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}/policies/{policy_kind}:preview", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Aday ayarı kaydetmeden değerlendirir. Gövde `putOrganizationPolicy` ile aynıdır ve aynı doğrulamadan, aynı\nplan kapısından geçer: geçersiz aday aynı hatayı döner (`422 validation_failed`, `422 policy_weaker_than_parent`,\n`422 at_least_one_method`, `409 domain_not_verified`, `409 connection_test_required`,\n`409 organization_pending_deletion`, `403 plan_feature_unavailable`). Hiçbir şey yazılmaz: `If-Match` ve `Idempotency-Key` yoktur, audit ve olay\nyazılmaz. Geçerli adayda yanıt, ayarın giriş anında uygulanacağı kullanıcıların sayısını (`affected_count`) ve\nkimliğe göre sıralı en çok 20 örneği (`sample`, yalnız `usr_…`) verir. Sayım tabanı `basis = users_in_scope`'tur:\norg'un etkin kullanıcılı etkin üyeleri; `sso_enforcement.mode = verified_domains`'te ayrıca org'un doğrulanmış\nalanlarından birinde e-postası olan etkin ortam kullanıcıları; break-glass kullanıcıları hariç; `required_for`/\n`applies_to = none` ya da `mode = off` ise 0. Sayı kullanıcının ayarı bugün karşılayıp karşılamadığını süzmez;\nsüzülmeyen koşullar `not_evaluated`'dadır: `admin_scope` (`admins` kapsamı bugün tüm üyelere uygulanır),\n`credentials`, `mfa_enrollment`, `passkey_enrollment`, `federated_sign_in`, `client_ip`. İstisna\n`phishing_resistant`'tır: kapsam boş değil ve en çok 10.000 kullanıcıysa sayı ve örnek\n`basis = users_without_webauthn` ile kapsamdakilerden bugün oltalamaya dayanıklı giremeyecek olanlardır (ayarın ya\nda ortamın AAGUID listesinin kabul ettiği etkin bir WebAuthn kimlik bilgisi, yani passkey ya da birinci faktörle\ngüvenlik anahtarı olmayanlar); `passkey_enrollment` yerine `credential_policy` (ortamın attestation zorunluluğu,\ncihaza bağlı passkey kuralı ve FIDO MDS model durumu uygulanmadı) yazılır. Daha büyük kapsamda ya da kimlik\ndoğrulama servisi bağlı değilse `users_in_scope` ve `passkey_enrollment` kalır; kayıt olgusu sorulamazsa\n`503 service_unavailable` döner (tahmini sayı dönmez).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "policies", "{{policy_kind}}:preview" ], "raw": "{{baseUrl}}/organizations/:org_id/policies/{{policy_kind}}:preview", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "GET /v1/organizations/{org_id}/roles", "request": { "description": "Org'a özgü rolleri kimlik sırasıyla (eskiden yeniye) imleçli listeler; yalnız ileri sayfalama (`after`)\nvardır (`before` ve `asc` dışı `order` `422`). Sayfa 1–100 kayıt, varsayılan 20. İmleç org'a\nbağlıdır; başka listenin imleci `400 invalid_cursor`'dır. Org rolleri yalnız bu org'da görünür.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "roles" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/organizations/:org_id/roles", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}/roles", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Org'a özgü rolü oluşturur. `key` küçük harf, rakam, `_` ve `-` ile 1–64 karakterdir, kapsamında tekildir\n(`409 role_key_conflict`) ve sonradan değişmez. `is_privileged` ayrıcalıklı rolü\nişaretler: ayrıcalıklı rolü self-serviste yalnız `org_admin_role_id` rolünü taşıyan atayabilir; dış grup eşlemesi\n`roles:write` ve onay ister. `assignable_in_self_service` verilmezse `true`dur. Ortamda 1.000 ortam rolü, org başına 50 org rolü\nsınırı aşılırsa `409 role_limit_reached`. Org rolleri `org_custom_roles` plan hakkı ister (Business ve üstü; yoksa `403 plan_feature_unavailable`, ortamda kapalıysa `403 org_custom_roles_disabled`); org rolü ayrıcalıklı olamaz (`422`, `/is_privileged`) ve ortamın org rolü izin listesi boşsa oluşturulamaz. Org bu ortamda yoksa `404`.\nYanıt `ETag` taşır; yazma yönetim audit'ine `role.created` olarak düşer. `Idempotency-Key`\nisteğe bağlıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "roles" ], "raw": "{{baseUrl}}/organizations/:org_id/roles", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "GET /v1/organizations/{org_id}/roles/{role_id}", "request": { "description": "Rolü döndürür (`rol_…`). Rol yoksa, başka ortamda ya da başka org'daysa `404`. Yanıt `ETag`\ntaşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "roles", ":role_id" ], "raw": "{{baseUrl}}/organizations/:org_id/roles/:role_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "role_id", "value": "" } ] } } }, { "name": "DELETE /v1/organizations/{org_id}/roles/{role_id}", "request": { "description": "Rolü siler; yanıt gövdesizdir. Atanmış rol `force=true` olmadan `409 role_in_use`'dur; `force=true` üyelik\natamalarını aynı işlemde kaldırır; org'un yönetici ya da varsayılan üye rolü olarak kullanılan rol yine silinmez (`409 role_in_use`).\n`If-Match` isteğe bağlıdır; verilirse güncel `ETag` ile eşleşmelidir (`412`). Silme yönetim audit'ine `role.deleted`\nolarak düşer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "roles", ":role_id" ], "query": [ { "description": "`true` atanmış rolün üyelik atamalarını silmeyle aynı işlemde kaldırır.", "disabled": true, "key": "force", "value": "" } ], "raw": "{{baseUrl}}/organizations/:org_id/roles/:role_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "role_id", "value": "" } ] } } }, { "name": "PATCH /v1/organizations/{org_id}/roles/{role_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Rolü birleştirme yamasıyla (RFC 7396) günceller. `If-Match` zorunludur: yoksa `428`, sürüm eşleşmezse `412`.\nYazılabilir alanlar `name`, `description`, `is_privileged` ve `assignable_in_self_service`'tir; `key` değişmez (başka\nalan `400 unknown_field`). Org rolü ayrıcalıklı yapılamaz. Rol ayrıcalıklı\nyapılırsa ona bağlı dış grup eşlemeleri onaysız kalır ve `:approve` ile onaylanana dek rol vermez. Hiçbir\nalanı değiştirmeyen yama kaydı ve sürümü değiştirmez. Yanıt `ETag` taşır; yazma `role.updated` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "roles", ":role_id" ], "raw": "{{baseUrl}}/organizations/:org_id/roles/:role_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "role_id", "value": "" } ] } } }, { "name": "PUT /v1/organizations/{org_id}/roles/{role_id}/permissions", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Org rolünün izin kümesini tam küme olarak değiştirir (en çok 100). Her izin ortamın org özel rol izin listesinde\nolmalıdır (`422 permission_not_allowed`; `GET /v1/org-custom-role-permissions`); org rolleri kapalıysa\n`403 org_custom_roles_disabled`, plan hakkı yoksa `403 plan_feature_unavailable` (`org_custom_roles`, Business).\nBaşka org'un ya da ortamın rolü `404`'tür. `If-Match` isteğe bağlıdır (`412`). Yanıt güncel rolü ve `ETag`'i taşır;\ndeğişiklik `role.updated` (`change=permissions`) audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "roles", ":role_id", "permissions" ], "raw": "{{baseUrl}}/organizations/:org_id/roles/:role_id/permissions", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "role_id", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}/sessions:revoke", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Org'un bütün kullanıcılarının bu org bağlamında açılmış etkin oturumlarını, bu org'la verilmiş ya da bu oturumlara bağlı refresh token ailelerini iptal eder; org'un canlı access token'ları introspection ve iptal denetiminde artık kabul edilmez. Gövdede `reason` zorunludur (1–256 karakter, kontrol karakteri yok); yalnız yönetim audit kaydına not olarak yazılır, oturumların iptal nedeni `admin`'dir. Org bu ortamda yoksa 404 döner. Zaten iptal edilmiş oturumlar sayılmaz; tekrar çağrı başarıdır. Tek oturum ya da tek kullanıcı için `POST /v1/users/{user_id}/sessions:revoke` kullanılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", ":org_id", "sessions:revoke" ], "raw": "{{baseUrl}}/organizations/:org_id/sessions:revoke", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "org_id", "value": "" } ] } } }, { "name": "POST /v1/organizations/{org_id}:cancel-deletion", "request": { "description": "Org yöneticisinin self-servis silme isteğini vade (`deletion_due_at`) gelmeden geri alır. Gövde yoktur. Silinmeyi beklemeyen org'da değişiklik yapmadan `200` döner. `organization.deletion_cancelled` olayı yayımlanır. Yanıt güncel org'u ve `ETag`'i taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", "{{org_id}}:cancel-deletion" ], "raw": "{{baseUrl}}/organizations/{{org_id}}:cancel-deletion" } } }, { "name": "POST /v1/organizations/{org_id}:disable", "request": { "description": "Org'u devre dışı bırakır: üyeler org bağlamında oturum açamaz, kayıt ve üyelikler korunur. Gövde yoktur. Zaten devre dışı org'da değişiklik yapmadan `200` döner; silinmeyi bekleyen org'da `409 organization_pending_deletion`. `organization.disabled` olayı yayımlanır ve yönetim audit'ine yazılır. Yanıt güncel org'u ve `ETag`'i taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", "{{org_id}}:disable" ], "raw": "{{baseUrl}}/organizations/{{org_id}}:disable" } } }, { "name": "POST /v1/organizations/{org_id}:enable", "request": { "description": "Devre dışı org'u yeniden etkinleştirir. Gövde yoktur. Zaten etkin org'da değişiklik yapmadan `200` döner; silinmeyi bekleyen org'da `409 organization_pending_deletion` (önce `:cancel-deletion`). `organization.enabled` olayı yayımlanır. Yanıt güncel org'u ve `ETag`'i taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "organizations", "{{org_id}}:enable" ], "raw": "{{baseUrl}}/organizations/{{org_id}}:enable" } } } ], "name": "organizations" }, { "description": "`/v1/permissions` kaynak ailesi.", "item": [ { "name": "GET /v1/permissions", "request": { "description": "Bir API'nin izinlerini (OAuth scope'ları) imleçli sayfalarla listeler. `api_id` zorunludur; ortam yalnız kimlik bilgisinden gelir, olmayan ya da başka ortama ait API `404`'tür. Sıralama izin kimliği (oluşturma sırası) ile kararlıdır (`order`, varsayılan `desc`). İmleç `api_id` ve sıralamaya bağlıdır; değişirse `400 invalid_cursor`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "permissions" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" }, { "description": "İzinleri listelenecek API (önekli dış kimlik `api_…`). Yoksa `422 required`, tekrarlanırsa `422 repeated`, biçimsizse `422 invalid_value` (`/api_id`).", "key": "api_id", "value": "" } ], "raw": "{{baseUrl}}/permissions?api_id=" } } }, { "name": "POST /v1/permissions", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "API'ye yeni bir izin (OAuth scope'u) ekler. `api_id` ve `value` zorunludur; `value` `kaynak:eylem` biçimindedir, API içinde tekildir, oluşturulduktan sonra değişmez ve `idp_` öneki sistem API'sine ayrılmıştır. `display_name`, `description` ve `consent_text_i18n` onay ekranında gösterilen düz metinlerdir: kontrol karakteri, satır/paragraf ayırıcı ve yön geçersiz kılma karakteri `422 invalid` olur; baştaki ve sondaki boşluk kırpılır, kırpılınca boş kalan alan `null` olur. Olmayan ya da başka ortama ait API `404`'tür. Sistem API'sine izin eklenemez (`409 conflict`); API başına en çok 1.000 izin vardır (aşımı `403 quota_exceeded`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "permissions" ], "raw": "{{baseUrl}}/permissions" } } }, { "name": "DELETE /v1/permissions/{permission_id}", "request": { "description": "İzni siler; rollerdeki ve uygulama izin listelerindeki atamaları da kaldırılır. Sistem API'sinin izinleri silinemez (`409 conflict`). Olmayan, başka ortama ait ya da biçimsiz kimlik `404`'tür.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "permissions", ":permission_id" ], "raw": "{{baseUrl}}/permissions/:permission_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "permission_id", "value": "" } ] } } }, { "name": "PATCH /v1/permissions/{permission_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İzni RFC 7396 birleştirme yamasıyla günceller (`application/merge-patch+json`). Yamada bulunmayan alan korunur; `display_name`, `description` ve `consent_text_i18n` `null` ile temizlenir, `sensitivity` temizlenemez (`422 required`). `consent_text_i18n` bütün harita olarak değişir: dil başına birleştirme yapılmaz, verilen harita eskisinin yerine geçer. `value` yalnız mevcut değerle aynıysa kabul edilir (`422 immutable`). Boş yama `422 required`'dır. İzin satırında sürüm yoktur; `If-Match` kullanılmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "permissions", ":permission_id" ], "raw": "{{baseUrl}}/permissions/:permission_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "permission_id", "value": "" } ] } } } ], "name": "permissions" }, { "description": "`/v1/platform-incidents` kaynak ailesi.", "item": [ { "name": "GET /v1/platform-incidents/{incident_id}/affected-users", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "platform-incidents", ":incident_id", "affected-users" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/platform-incidents/:incident_id/affected-users", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "incident_id", "value": "" } ] } } } ], "name": "platform-incidents" }, { "description": "`/v1/privacy-requests` kaynak ailesi.", "item": [ { "name": "GET /v1/privacy-requests", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "privacy-requests" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/privacy-requests" } } }, { "name": "POST /v1/privacy-requests", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "privacy-requests" ], "raw": "{{baseUrl}}/privacy-requests" } } }, { "name": "GET /v1/privacy-requests/{privacy_request_id}", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "privacy-requests", ":privacy_request_id" ], "raw": "{{baseUrl}}/privacy-requests/:privacy_request_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "privacy_request_id", "value": "" } ] } } }, { "name": "PATCH /v1/privacy-requests/{privacy_request_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "privacy-requests", ":privacy_request_id" ], "raw": "{{baseUrl}}/privacy-requests/:privacy_request_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "privacy_request_id", "value": "" } ] } } } ], "name": "privacy-requests" }, { "description": "`/v1/reports` kaynak ailesi.", "item": [ { "name": "GET /v1/reports/active-users", "request": { "description": "İskelet işlem; davranış plan satırındadır. Not: bkz. getActivityReport", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "reports", "active-users" ], "raw": "{{baseUrl}}/reports/active-users" } } }, { "name": "GET /v1/reports/activity", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "reports", "activity" ], "raw": "{{baseUrl}}/reports/activity" } } }, { "name": "GET /v1/reports/auth-methods", "request": { "description": "İskelet işlem; davranış plan satırındadır. Not: bkz. getActivityReport", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "reports", "auth-methods" ], "raw": "{{baseUrl}}/reports/auth-methods" } } }, { "name": "GET /v1/reports/availability", "request": { "description": "İskelet işlem; davranış plan satırındadır. Not: Enterprise", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "reports", "availability" ], "raw": "{{baseUrl}}/reports/availability" } } }, { "name": "GET /v1/reports/deprecation-usage", "request": { "description": "Kullanımdan kalkan işlemlerin çağrı sayımlarını `from`–`to` aralığında (UTC günü, ikisi dahil) `deprecation_id`, `client_id`, `sdk_package`, `sdk_version` başına toplar; sıra bu dört alanın bayt sırasıdır. `from` yoksa `to` − 30 gün, `to` yoksa bugün (UTC). Rapor ortamın kendi çağrılarını kapsar; satırlarda IP, User-Agent ve kullanıcı kimliği yoktur. `sunset_at` kullanımdan kaldırma kayıt defterindendir (bilinmiyorsa `null`). Geçmiş derinliği planın derinliğidir (Free 30 gün, ücretli 13 ay, Enterprise 25 ay) ve en çok 400 gündür; daha eski `from` `422 report_range_exceeds_plan` döner ve izin verilen en eski günü `errors[0].detail` içinde taşır. `from` > `to` ya da biçimsiz tarih `400 invalid_filter`, başka ortama ya da başka aralığa ait imleç `400 invalid_cursor` döner. `Accept: text/csv` aynı kolonları CSV olarak döner; CSV yanıtında sonraki sayfanın imleci `Link: <…>; rel=\"next\"` başlığındadır. Kullanım kaydı henüz yoksa ya da kayıt defteri boşsa liste boştur. Rapor faturalama girdisi değildir; sayımlar dakikalık toplanır ve çökmede en çok 60 sn'lik sayım kaybolabilir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "reports", "deprecation-usage" ], "query": [ { "description": "Dahil alt sınır, UTC günü (RFC 3339 tam tarih, `YYYY-AA-GG`). Yoksa `to` − 30 gün. Planın derinliğinden eski değer `422 report_range_exceeds_plan` döner.", "disabled": true, "key": "from", "value": "" }, { "description": "Dahil üst sınır, UTC günü (RFC 3339 tam tarih, `YYYY-AA-GG`). Yoksa bugün (UTC). `from` ≤ `to` olmalıdır.", "disabled": true, "key": "to", "value": "" }, { "disabled": true, "key": "limit", "value": "" }, { "description": "Önceki yanıtın `next_cursor` değeri; yalnız üretildiği ortam, `from` ve `to` ile geçerlidir.", "disabled": true, "key": "cursor", "value": "" } ], "raw": "{{baseUrl}}/reports/deprecation-usage" } } }, { "name": "GET /v1/reports/inactive-members", "request": { "description": "Org'un `active` üyeliklerinden, son `days` günde (7–365, varsayılan 30) org bağlamında başarılı kimlik doğrulaması olmayanları listeler. SCIM'siz bağlantılarda deprovizyonun dayanağıdır; seçilen üyelikler `POST /v1/organizations/{org_id}/memberships/{membership_id}:suspend` ile askıya alınır. \"Başarılı kimlik doğrulama\" bu org'un bağlamında tamamlanan giriştir; org seçilmeden yapılan giriş sayılmaz. Etkinleşmesi (`activated_at`) eşikten yeni olan üyelik listelenmez. Kayıt yalnız ortam için işlenen ilk girişten (`data_since`) sonrasını bilir: `complete` `false` iken listedeki üyeler `data_since`'ten önce girmiş olabilir; `data_since` `null` ise ortamda henüz kayıt yoktur. Bir sayfa en çok 500 üyeliği tarar ve `limit`'ten az satırla dönebilir; `next_cursor` `null` olana dek devam edin. Sıra üyeliğin son güncellenme sırasıdır. Bilinmeyen ya da başka ortamın org'u `404`, eksik ya da biçimsiz `organization_id` ve aralık dışı `days` `422 validation_failed`, başka ortama ya da başka sorguya ait imleç `400 invalid_cursor` döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "reports", "inactive-members" ], "query": [ { "description": "Raporun org'u (`org_…`); zorunlu.", "key": "organization_id", "value": "" }, { "description": "Hareketsizlik eşiği (gün): bu kadar gündür org bağlamında girişi olmayan üyeler.", "disabled": true, "key": "days", "value": "" }, { "disabled": true, "key": "limit", "value": "" }, { "description": "Önceki yanıtın `next_cursor` değeri; yalnız üretildiği ortam, `organization_id` ve `days` ile geçerlidir.", "disabled": true, "key": "cursor", "value": "" } ], "raw": "{{baseUrl}}/reports/inactive-members?organization_id=" } } }, { "name": "GET /v1/reports/privacy-requests", "request": { "description": "İskelet işlem; davranış plan satırındadır. Not: izin planda yazılmamış", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "reports", "privacy-requests" ], "raw": "{{baseUrl}}/reports/privacy-requests" } } }, { "name": "GET /v1/reports/security", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "reports", "security" ], "raw": "{{baseUrl}}/reports/security" } } }, { "name": "GET /v1/reports/security-posture", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "reports", "security-posture" ], "raw": "{{baseUrl}}/reports/security-posture" } } } ], "name": "reports" }, { "description": "`/v1/roles` kaynak ailesi.", "item": [ { "name": "GET /v1/roles", "request": { "description": "Ortam rollerini kimlik sırasıyla (eskiden yeniye) imleçli listeler; yalnız ileri sayfalama (`after`)\nvardır (`before` ve `asc` dışı `order` `422`). Sayfa 1–100 kayıt, varsayılan 20. İmleç ortam listesine\nbağlıdır; başka listenin imleci `400 invalid_cursor`'dır. Org rolleri bu listede yoktur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "roles" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/roles" } } }, { "name": "POST /v1/roles", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortam rolü oluşturur. `key` küçük harf, rakam, `_` ve `-` ile 1–64 karakterdir, kapsamında tekildir\n(`409 role_key_conflict`) ve sonradan değişmez. `is_privileged` ayrıcalıklı rolü\nişaretler: ayrıcalıklı rolü self-serviste yalnız `org_admin_role_id` rolünü taşıyan atayabilir; dış grup eşlemesi\n`roles:write` ve onay ister. `assignable_in_self_service` verilmezse `true`dur. Ortamda 1.000 ortam rolü, org başına 50 org rolü\nsınırı aşılırsa `409 role_limit_reached`. Yanıt `ETag` taşır; yazma yönetim audit'ine `role.created` olarak düşer. `Idempotency-Key`\nisteğe bağlıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "roles" ], "raw": "{{baseUrl}}/roles" } } }, { "name": "GET /v1/roles/{role_id}", "request": { "description": "Rolü döndürür (`rol_…`). Rol yoksa, başka ortamda ya da bir org'a aitse `404`. Yanıt `ETag`\ntaşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "roles", ":role_id" ], "raw": "{{baseUrl}}/roles/:role_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "role_id", "value": "" } ] } } }, { "name": "DELETE /v1/roles/{role_id}", "request": { "description": "Rolü siler; yanıt gövdesizdir. Atanmış rol `force=true` olmadan `409 role_in_use`'dur; `force=true` üyelik\natamalarını aynı işlemde kaldırır; org'un yönetici ya da varsayılan üye rolü olarak kullanılan rol yine silinmez (`409 role_in_use`).\n`If-Match` isteğe bağlıdır; verilirse güncel `ETag` ile eşleşmelidir (`412`). Silme yönetim audit'ine `role.deleted`\nolarak düşer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "roles", ":role_id" ], "query": [ { "description": "`true` atanmış rolün üyelik atamalarını silmeyle aynı işlemde kaldırır.", "disabled": true, "key": "force", "value": "" } ], "raw": "{{baseUrl}}/roles/:role_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "role_id", "value": "" } ] } } }, { "name": "PATCH /v1/roles/{role_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Rolü birleştirme yamasıyla (RFC 7396) günceller. `If-Match` zorunludur: yoksa `428`, sürüm eşleşmezse `412`.\nYazılabilir alanlar `name`, `description`, `is_privileged` ve `assignable_in_self_service`'tir; `key` değişmez (başka\nalan `400 unknown_field`). Rol ayrıcalıklı\nyapılırsa ona bağlı dış grup eşlemeleri onaysız kalır ve `:approve` ile onaylanana dek rol vermez. Hiçbir\nalanı değiştirmeyen yama kaydı ve sürümü değiştirmez. Yanıt `ETag` taşır; yazma `role.updated` audit'idir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "roles", ":role_id" ], "raw": "{{baseUrl}}/roles/:role_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "role_id", "value": "" } ] } } }, { "name": "PUT /v1/roles/{role_id}/permissions", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Rolün izin kümesini tam küme olarak değiştirir (`permission_ids`; boş dizi bütün izinleri kaldırır, sıra önemsizdir,\ntekrar `422 duplicate`). Ortam rolü en çok 500, org rolü en çok 100 izin taşır (`422 too_many`); bilinmeyen izin\n`422 unknown_permission`. Org yönetici rolü yapılan ortam rolünden sistem izni çıkarılamaz (`422 permission_reserved`).\n`If-Match` isteğe bağlıdır; verilirse güncel `ETag` ile eşleşmelidir (`412`) ve sürüm yazmaya sabitlenir. Aynı küme\ntekrar yazılırsa kayıt ve sürüm değişmez. Yanıt güncel rolü ve `ETag`'i taşır; değişiklik yönetim audit'ine\n`role.updated` (`change=permissions`) olarak düşer.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "roles", ":role_id", "permissions" ], "raw": "{{baseUrl}}/roles/:role_id/permissions", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "role_id", "value": "" } ] } } } ], "name": "roles" }, { "description": "`/v1/sessions` kaynak ailesi.", "item": [ { "name": "GET /v1/sessions/{session_id}", "request": { "description": "Tek oturumu döner (her durumda: `active`, `expired`, `revoked`). Oturum bu ortamda yoksa 404. Tam IP adresi görünür ve görüntüleme yönetim audit'ine yazılır. Çerez, token ya da cihaz parmak izi dönmez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "sessions", ":session_id" ], "raw": "{{baseUrl}}/sessions/:session_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "session_id", "value": "" } ] } } }, { "name": "POST /v1/sessions/{session_id}:revoke", "request": { "description": "Oturumu ve ona bağlı refresh token ailelerini iptal eder; o oturumla verilmiş access token'lar iptal işaretçisiyle (`sid`) geçersiz sayılır. Gövde yoktur. Oturum bu ortamda yoksa 404. Zaten iptal edilmiş ya da süresi dolmuş oturumda bir şey değişmez ve `already_inactive: true` döner. İptal yönetim audit'ine yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "sessions", "{{session_id}}:revoke" ], "raw": "{{baseUrl}}/sessions/{{session_id}}:revoke" } } } ], "name": "sessions" }, { "description": "`/v1/signing-keys` kaynak ailesi.", "item": [ { "name": "GET /v1/signing-keys", "request": { "description": "Ortamın JWKS'inde yayımdaki token imza anahtarlarını döndürür: `next` (yayımlanmış, henüz imzalamayan),\n`active` (imzalayan) ve `retired` (imzalamayı bırakmış, 7 gün doğrulama için yayımda). Sıra `next`, `active`,\nsonra `retired` (yeniden eskiye). JWKS'ten çıkmış (`removed`) ve acil rotasyonla iptal edilmiş (`revoked`)\nanahtarlar dönmez. Liste JWKS kadar küçüktür ve sayfalanmaz; `list_metadata` imleçleri her zaman null'dır. Yanıt\nyalnız açık bilgidir: `kid` RFC 7638 JWK SHA-256 thumbprint'idir (base64url); özel anahtar hiçbir yanıtta yoktur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "signing-keys" ], "raw": "{{baseUrl}}/signing-keys" } } }, { "name": "GET /v1/signing-keys/policy", "request": { "description": "Ortamın imza anahtarı politikasını döndürür: algoritma, otomatik rotasyon aralığı, saklama biçimi\nve sonraki otomatik rotasyon zamanı. Politika hiç yazılmadıysa varsayılanlar (`RS256`, 180 gün, `wrapped`) ve\n`ETag: \"0\"` döner; `updated_at` null'dır. Yanıt `ETag` başlığı taşır (`PATCH` için `If-Match`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "signing-keys", "policy" ], "raw": "{{baseUrl}}/signing-keys/policy" } } }, { "name": "PATCH /v1/signing-keys/policy", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İmza anahtarı politikasını değiştirir (RFC 7396 birleştirme yaması; yalnız verilen alanlar değişir). `If-Match`\nzorunludur (yoksa `428`, eşleşmezse `412`). Kurallar: `rotation_interval_days` 30–365; `algorithm` `RS256`,\n`ES256`, `PS256` ya da `EdDSA`; `storage: transit` (dışa aktarılamaz anahtar saklama) Enterprise içindir ve bu\nsürümde `422` döner. Alanlar null olamaz.\n\nAlgoritma değişimi kesintisizdir: yeni algoritmayla yeni bir `next` anahtar JWKS'te yayımlanır; bu anahtar en\nerken 7 gün sonra etkinleşebilir (öncesindeki `immediate` rotasyon `409 next_key_too_young`). Doğrulayıcılar\ntoken'ın algoritmasını `kid`'in JWK'sinden almalıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "signing-keys", "policy" ], "raw": "{{baseUrl}}/signing-keys/policy" } } }, { "name": "POST /v1/signing-keys:rotate", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortamın token imza anahtarını ya da bir federasyon anahtarını hemen döndürür.\n\n- `mode: immediate`: olağan rotasyon adımı hemen çalışır: önceden yayımlanmış `next` imzalamaya başlar, eski\n `active` 7 gün `retired` kalır, yeni bir `next` yayımlanır. `next`'in algoritması etkin anahtarınkinden farklıysa\n (algoritma değişimi) ve `next` 7 günden gençse `409 next_key_too_young`. Ortamın `next`'i yoksa `409 conflict`.\n- `mode: emergency` (anahtarın ele geçtiği şüphesi): eski `active` `revoked` olur ve JWKS'ten **anında** çıkar;\n `next` etkinleşir ve yeni `next` üretilir. `revoke_next: true` `next`'i de iptal eder ve hiç yayımlanmamış yeni\n bir anahtarı etkinleştirir. `revoke_sessions: true` ortamın tüm refresh token ailelerini ve oturumlarını da\n iptal eder (kullanıcılar yeniden giriş yapar). `reason` zorunludur: yazdırılabilir ASCII, 1–512 bayt (olay ya\n da kayıt numarası; sır ya da kişisel veri yazmayın). Acil kip, `signing-keys:write`'a ek olarak kimlik bilgisinde\n açıkça verilmiş `signing-keys:emergency` izni ister: yalnız bu izni taşıyan kısıtlı anahtar ya da M2M istemcisi\n çağırabilir; tüm izinli gizli anahtar (`idp_sk_`) acil kipte `403 insufficient_permissions` alır.\n- `use`: döndürülecek anahtar; varsayılan `token_signing` (access/ID token imza anahtarı). Federasyon\n anahtarları ortam başınadır: `saml_sp_signing` ve `saml_sp_encryption` SAML SP imza ve şifreleme anahtarları, `oidc_rp_signing` kurumsal OIDC bağlantılarının `private_key_jwt`\n anahtarı. Federasyon anahtarında `immediate`, takvimin 30 gün önceden yayımladığı\n `next` anahtarı hemen etkinleştirir; eski anahtar 30 gün daha yayımda kalır (`retired_kids`). `next` yoksa\n `409 conflict`, 7 günden kısa süredir yayımdaysa `409 next_key_too_young`. `emergency` etkin anahtarı\n yayımdan anında çıkarır ve özel anahtarını yok eder; yayımdaki `next` (ya da yoksa veya `revoke_next: true`\n ise hiç yayımlanmamış yeni anahtar) etkinleşir. Metadata'yı ya da sertifikayı elle yüklemiş IdP'lerde yeni\n sertifika yüklenene kadar giriş başarısız olabilir; bu durumda bağlantı başına\n `connection.sp_certificate_rotation_started` web kancası olayı üretilir. Federasyon anahtarında\n `revoke_sessions` kullanılamaz; yanıtta `next_kid` null'dır (sonraki anahtarı yıllık takvim yayımlar).\n Ortamda o kullanımın etkin anahtarı yoksa (SAML ya da `private_key_jwt` hiç kullanılmadıysa) `409 conflict`.\n- `connection_id` (yalnız `saml_sp_signing` ve `saml_sp_encryption`): ortam kümesi yerine o SAML bağlantısının\n kendine ait SP anahtar kümesini aynı kip, izin ve kurallarla döndürür. Web\n kancası olayı yalnız o bağlantı için üretilir, ortamın ve diğer bağlantıların anahtarları değişmez; audit\n kaydının hedefi ortamdır, bağlantı `metadata.connection_id`'de yazılır. Bilinmeyen ya da başka ortamın bağlantısı `404 not_found`, ortamın anahtarlarını kullanan bağlantı\n `409 connection_keys_not_dedicated`; `token_signing` ya da `oidc_rp_signing` ile `422 /connection_id\n not_allowed`. Alan verilmezse ortamın kümesi döner.\n\nYeni token imza anahtarlarının algoritması ortam politikasınındır (`GET /v1/signing-keys/policy`); federasyon\nanahtarları her zaman RSA-3072'dir. Başarılı token anahtarı rotasyonu `signing_key.rotated` ya da\n`signing_key.revoked` web kancası olayını, her rotasyon yönetim audit kaydını üretir. Bu uç\n\"anahtar ve sır üretimi\" hız sınırı ailesindedir. `Idempotency-Key` önerilir: başlık sahip servise de\niletilir, ağ hatasından sonraki tekrar ikinci bir rotasyon yapmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "signing-keys:rotate" ], "raw": "{{baseUrl}}/signing-keys:rotate" } } } ], "name": "signing-keys" }, { "description": "`/v1/sms-provider` kaynak ailesi.", "item": [ { "name": "GET /v1/sms-provider", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "sms-provider" ], "raw": "{{baseUrl}}/sms-provider" } } }, { "name": "PUT /v1/sms-provider", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "sms-provider" ], "raw": "{{baseUrl}}/sms-provider" } } }, { "name": "POST /v1/sms-provider:test", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "sms-provider:test" ], "raw": "{{baseUrl}}/sms-provider:test" } } } ], "name": "sms-provider" }, { "description": "`/v1/sms-templates` kaynak ailesi.", "item": [ { "name": "GET /v1/sms-templates/{family}/{locale}", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "sms-templates", ":family", ":locale" ], "raw": "{{baseUrl}}/sms-templates/:family/:locale", "variable": [ { "description": "Yol anahtarı.", "key": "family", "value": "" }, { "description": "Yol anahtarı.", "key": "locale", "value": "" } ] } } }, { "name": "PUT /v1/sms-templates/{family}/{locale}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "sms-templates", ":family", ":locale" ], "raw": "{{baseUrl}}/sms-templates/:family/:locale", "variable": [ { "description": "Yol anahtarı.", "key": "family", "value": "" }, { "description": "Yol anahtarı.", "key": "locale", "value": "" } ] } } }, { "name": "POST /v1/sms-templates/{family}/{locale}:publish", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "sms-templates", ":family", "{{locale}}:publish" ], "raw": "{{baseUrl}}/sms-templates/:family/{{locale}}:publish", "variable": [ { "description": "Yol anahtarı.", "key": "family", "value": "" } ] } } }, { "name": "POST /v1/sms-templates/{family}/{locale}:rollback", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "sms-templates", ":family", "{{locale}}:rollback" ], "raw": "{{baseUrl}}/sms-templates/:family/{{locale}}:rollback", "variable": [ { "description": "Yol anahtarı.", "key": "family", "value": "" } ] } } } ], "name": "sms-templates" }, { "description": "`/v1/support-access-grants` kaynak ailesi.", "item": [ { "name": "GET /v1/support-access-grants", "request": { "description": "Ortamın platform destek erişim izinlerini\nimleçli listeler; sıralama her zaman yeniden eskiye, yalnız ileri sayfalama (`after`) vardır (`before` ve `desc`\ndışı `order` `422`). `status` süzgeci `active`, `revoked` ya da `expired`'dır; `expired` iptal edilmemiş ve\n`expires_at` anı geçmiş izindir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "support-access-grants" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Durum süzgeci.", "disabled": true, "key": "status", "value": "" } ], "raw": "{{baseUrl}}/support-access-grants" } } }, { "name": "POST /v1/support-access-grants", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "KeenAuth destek personeline bu ortam için süreli erişim izni verir. `scope` `read` (yalnız okuma) ya da\n`read_write_config` (yapılandırma yazma; kullanıcı verisi yazımı yoktur), `duration_hours` 1–72 saat,\n`ticket_ref` destek talebi başvurusudur (1–200 yazdırılabilir ASCII karakter, başta ve sonda boşluk yok).\n`allowed_regions_of_staff` (`eu`, `us`) erişimi yalnız o bölgelerde konumlu personele sınırlar; yalnız\nEnterprise planında (`403 plan_feature_unavailable`). İzin yalnız panodan, `owner` ya da `admin` rolüyle ve son\n300 saniye içinde adım yükseltmeyle verilir; API anahtarı ve makine istemcisi `403\ninsufficient_permissions` alır. Personelin izni kullanması ve her erişimi yönetim audit'ine yazılır;\n`support_access_grant.created` olayı yayımlanır. `Idempotency-Key` isteğe bağlıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "support-access-grants" ], "raw": "{{baseUrl}}/support-access-grants" } } }, { "name": "GET /v1/support-access-grants/{grant_id}", "request": { "description": "Bir destek erişim iznini döndürür. Biçimsiz ya da başka ortamın kimliği `404 not_found` döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "support-access-grants", ":grant_id" ], "raw": "{{baseUrl}}/support-access-grants/:grant_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "grant_id", "value": "" } ] } } }, { "name": "DELETE /v1/support-access-grants/{grant_id}", "request": { "description": "Destek erişim iznini süresi dolmadan iptal eder: `revoked_at` yazılır, personelin bu izne dayanan erişimi biter ve\n`support_access_grant.revoked` olayı yayımlanır. Kayıt silinmez (audit). Zaten iptal edilmiş ya da süresi dolmuş\nizinde değişiklik yapılmaz ve yine `204` döner. Yalnız panodan, `owner` ya da `admin` rolüyle ve son 300\nsaniye içinde adım yükseltmeyle; API anahtarı ve makine istemcisi `403 insufficient_permissions` alır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "support-access-grants", ":grant_id" ], "raw": "{{baseUrl}}/support-access-grants/:grant_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "grant_id", "value": "" } ] } } } ], "name": "support-access-grants" }, { "description": "`/v1/support-artifacts` destek eki yüklemesi.", "item": [ { "name": "POST /v1/support-artifacts", "request": { "body": { "mode": "raw", "raw": "" }, "description": "Destek talebine HAR ya da log eki yükler. Ek yüklemenin tek yolu pano \"Destek\"\nsayfasıdır: API anahtarı ve yönetim istemcisi izin taşısa bile `403 insufficient_permissions` alır. Gövde ham ektir\n(`application/octet-stream`); `Content-Encoding: gzip` kabul edilir (tel üzerinde en çok 11 MiB, açılmış ek en\nçok 50 MB; aşımda `413`). Pano eki tarayıcıda temizleyip gönderir; sunucu eki ikinci kez tarar: `Cookie`,\n`Set-Cookie`, `Authorization`, `DPoP` başlıkları, OAuth/OIDC/SAML token alanları, `__Host-` çerezleri, JWT'ler ve\nKeenAuth önekli sırlar `[redacted]` olur. Bulunan yönetim API anahtarı (`idp_sk_`, `idp_rk_`) sızıntı akışıyla\nhemen iptal edilir; iptal edilemezse ek saklanmaz (`503`, yeniden deneyin). Yalnız temizlenmiş içerik\nortamın veri anahtarıyla şifreli saklanır ve 30 gün sonra silinir. `kind=har` gövdesi HAR belgesi değilse `422`\n(`/body` `invalid_har`). Bilet başına en çok 10 ek (`403 quota_exceeded`). Yanıt içerik ve değer taşımaz; bulgular\nyalnız tür ve sayıdır. `Idempotency-Key` isteğe bağlıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/octet-stream" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "support-artifacts" ], "query": [ { "description": "Destek talebi başvurusu (1–64 karakter: harf, rakam, `_ . : -`; ilk karakter harf ya da rakam).", "key": "ticket_ref", "value": "" }, { "description": "`har` (HAR 1.2 JSON belgesi) ya da `log` (düz metin).", "key": "kind", "value": "" } ], "raw": "{{baseUrl}}/support-artifacts?ticket_ref=&kind=" } } } ], "name": "support-artifacts" }, { "description": "`/v1/token-exchange-policies` kaynak ailesi.", "item": [ { "name": "GET /v1/token-exchange-policies", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "token-exchange-policies" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/token-exchange-policies" } } }, { "name": "POST /v1/token-exchange-policies", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "token-exchange-policies" ], "raw": "{{baseUrl}}/token-exchange-policies" } } }, { "name": "GET /v1/token-exchange-policies/{policy_id}", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "token-exchange-policies", ":policy_id" ], "raw": "{{baseUrl}}/token-exchange-policies/:policy_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "policy_id", "value": "" } ] } } }, { "name": "DELETE /v1/token-exchange-policies/{policy_id}", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "token-exchange-policies", ":policy_id" ], "raw": "{{baseUrl}}/token-exchange-policies/:policy_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "policy_id", "value": "" } ] } } }, { "name": "PATCH /v1/token-exchange-policies/{policy_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "token-exchange-policies", ":policy_id" ], "raw": "{{baseUrl}}/token-exchange-policies/:policy_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "policy_id", "value": "" } ] } } } ], "name": "token-exchange-policies" }, { "description": "`/v1/usage` kaynak ailesi.", "item": [ { "name": "GET /v1/usage", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "usage" ], "raw": "{{baseUrl}}/usage" } } } ], "name": "usage" }, { "description": "`/v1/users` kaynak ailesi.", "item": [ { "name": "GET /v1/users", "request": { "description": "Kişisel veri içermeyen süzgeçlerle kullanıcıları imleçli listeler (`created_at` ve kimlik sırasıyla). E-posta, telefon, ad ve kullanıcı adı süzgeçleri bu uçta yoktur; bunlar için `POST /v1/users:search` kullanılır. Toplam sayı döndürülmez. Kimlik bilgisi `users:read_pii` iznini taşımıyorsa yanıttaki kişisel veri maskelenir: `email` `a***@e***.com` biçiminde, `phone_number` son 2 hane dışında `*`, `name`, `given_name`, `family_name`, `middle_name` ve `nickname` baş harfler, `username` ilk karakter ve `***`, `birthdate` `****-**-**`, `address` `{\"redacted\": true}` olur; `user_metadata` ve `app_metadata` maskelenmez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" }, { "description": "Kullanıcı durumuna göre süzer.", "disabled": true, "key": "status", "value": "" }, { "description": "Müşterinin kendi kimliğiyle tam eşleşme.", "disabled": true, "key": "external_id", "value": "" }, { "description": "Bu andan (RFC 3339) sonra oluşturulanlar.", "disabled": true, "key": "created_after", "value": "" }, { "description": "Bu andan (RFC 3339) önce oluşturulanlar.", "disabled": true, "key": "created_before", "value": "" } ], "raw": "{{baseUrl}}/users" } } }, { "name": "POST /v1/users", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortamda yeni bir kullanıcı oluşturur. E-posta, telefon numarası ya da kullanıcı adından en az biri gerekir. Kullanıcı ortama bağlıdır; aynı e-posta iki ortamda iki ayrı kullanıcıdır. Yanıt `ETag` başlığında kullanıcı sürümünü taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users" ], "raw": "{{baseUrl}}/users" } } }, { "name": "GET /v1/users/{user_id}", "request": { "description": "Returns a user. The response carries the user version in the `ETag` header. A user that belongs to another environment, does not exist, or has been deleted returns `404`. With `include=deleted`, a deleted user returns `410` with `deleted_at`, `deletion_id`, `backups_purged_by` and, for a merged user, `merged_into`. Without the `users:read_pii` permission the credential receives masked personal data: `email` as `a***@e***.com`, `phone_number` with every digit but the last 2 replaced by `*`, `name`, `given_name`, `family_name`, `middle_name` and `nickname` as initials, `username` as its first character and `***`, `birthdate` as `****-**-**`, `address` as `{\"redacted\": true}`; `user_metadata` and `app_metadata` are not masked.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "query": [ { "description": "Set to `deleted` to get a tombstone (`410`) instead of `404` when the user has been deleted.", "disabled": true, "key": "include", "value": "" } ], "raw": "{{baseUrl}}/users/:user_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "DELETE /v1/users/{user_id}", "request": { "description": "Kullanıcının silinmesini başlatır. Kullanıcı hemen `pending_deletion` durumuna geçer ve silme vadesi şimdidir; kalıcı silme asenkron yürür. Yanıt `202` ve `deletion_id` döner; aynı kullanıcıya tekrarlanan istek aynı kimliği döndürür. Silme iptal penceresi tanınmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "raw": "{{baseUrl}}/users/:user_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "PATCH /v1/users/{user_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kullanıcıyı JSON merge-patch (RFC 7396) ile günceller. Metin alanları `null` ya da boş dizeyle temizlenir; `email_verified` ve `phone_verified` temizlenemez; `address` verilirse bütünüyle değişir; `user_metadata` ve `app_metadata` anahtar anahtar birleşir (`null` anahtarı siler); üyenin kendisi `null` verilirse tüm meta veri silinir ve `{}` olur. `If-Match` isteğe bağlıdır: verilirse kullanıcı sürümüyle eşleşmelidir. Durum bu uçtan değişmez; engellemek için `:block` kullanılır. Silinmekte olan kullanıcı güncellenemez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "raw": "{{baseUrl}}/users/:user_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/authenticators", "request": { "description": "Kullanıcının doğrulayıcılarının (passkey, TOTP, SMS, e-posta ve push faktörleri) üst verisini tek sayfada listeler; son 90 gündeki iptal edilmiş kayıtlar dahildir, oluşturma zamanına göre sıralıdır. Kullanıcı başına doğrulayıcı sayısı sınırlı olduğundan liste imleçsizdir: `limit`, `after`, `before`, `order` yoktur ve `list_metadata` her zaman `null` döner. Açık anahtar, kimlik bilgisi kimliği, TOTP sırrı ve kurtarma kodu hiçbir durumda dönmez. Kullanıcı bu ortamda yoksa 404 döner. Kimlik bilgisi `users:read_pii` iznini taşımıyorsa `label` baş harflere indirilir. Org kapsamı: `org_id` verilirse kimlik bilgisi ek olarak `organizations:read` iznini taşımalıdır (yoksa `403 insufficient_permissions`, directory ve authn'e gidilmez); kullanıcı o org'un üyesi değilse (`invited`, `active` ya da `suspended` üyeliği yoksa) `404 not_found` döner. Üyeyse yalnız sınıf ve \"MFA kayıtlı mı\" bilgisi döner: yalnız etkin doğrulayıcılar listelenir; `label`, `last_used_at`, `revoked_at`, `revoked_by`, `revoke_reason` `null`, `synced` `false` yazılır (kişinin cihaz bilgisi org'a ait değildir). MFA kaydı `role` `second_factor` ya da `both` olan bir etkin doğrulayıcıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "authenticators" ], "query": [ { "description": "Org kapsamı: `org_` önekli dış kimlik. Verilirse ek izin `organizations:read` gerekir ve yalnız o org bağlamındaki kayıtlar döner; kullanıcı org'un üyesi değilse `404`.", "disabled": true, "key": "org_id", "value": "" } ], "raw": "{{baseUrl}}/users/:user_id/authenticators", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "DELETE /v1/users/{user_id}/authenticators/{authenticator_id}", "request": { "description": "Tek doğrulayıcıyı (passkey dahil) iptal eder; `revoked_by` `admin:`, `revoke_reason` `admin_removed` olur. Doğrulayıcı zaten iptal edilmişse değişiklik yapmaz ve yine 204 döner. Kullanıcının oturumları kapatılmaz. Kullanıcı ya da doğrulayıcı bu ortamda yoksa (doğrulayıcı bu kullanıcıya ait değilse) 404 döner. Yönetim audit kaydı yazılır ve kullanıcıya güvenlik bildirimi gider.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "authenticators", ":authenticator_id" ], "raw": "{{baseUrl}}/users/:user_id/authenticators/:authenticator_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "authenticator_id", "value": "" } ] } } }, { "name": "POST /v1/users/{user_id}/authenticators/{authenticator_id}:reactivate", "request": { "description": "`clone_suspected` durumundaki doğrulayıcıyı (passkey sayaç anomalisi) yönetici kararıyla `active` durumuna döndürür; sayaç gelen son değere eşitlenir ve audit kaydı yazılır. Doğrulayıcı `clone_suspected` değilse 409 döner. Gövde yoktur; yanıt güncel doğrulayıcıdır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "authenticators", "{{authenticator_id}}:reactivate" ], "raw": "{{baseUrl}}/users/:user_id/authenticators/{{authenticator_id}}:reactivate", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "POST /v1/users/{user_id}/authenticators:reset", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kullanıcının tüm ikinci faktörlerini iptal eder ve kurtarma kodlarını siler; kullanıcı sonraki girişte faktörü yeniden kaydeder. `include_passkeys` verilmezse `true` kabul edilir; `false` ise passkey'ler (`both` rollü olanlar dahil) korunur. Adımlar en iyi çabayla koşar ve yinelenebilir; bildirim hatası çağrıyı düşürmez (`notified`). Yanıt sayıları taşır, kod ya da sır taşımaz. Bildirim dili `locale` ile verilebilir; boşsa kullanıcının ya da ortamın dili kullanılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "authenticators:reset" ], "raw": "{{baseUrl}}/users/:user_id/authenticators:reset", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/connected-accounts", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "connected-accounts" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/users/:user_id/connected-accounts", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "DELETE /v1/users/{user_id}/connected-accounts/{connected_account_id}", "request": { "description": "İskelet işlem; davranış plan satırındadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "connected-accounts", ":connected_account_id" ], "raw": "{{baseUrl}}/users/:user_id/connected-accounts/:connected_account_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "connected_account_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/consent-records", "request": { "description": "Kullanıcının hukuki belge rıza kayıtlarını imleçli listeler; sıralama her\nzaman `occurred_at` azalandır, yalnız ileri sayfalama (`after`) vardır. Biçimsiz kullanıcı kimliği `404 not_found`\ndöner; kaydı olmayan ya da ortamda bulunmayan kullanıcı boş liste alır. Kayıtlar IP, user-agent ya da oturum\nbilgisi taşımaz (kanıt aynı `occurred_at` anındaki ortam logundadır).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "consent-records" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/users/:user_id/consent-records", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "POST /v1/users/{user_id}/consent-records", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Müşterinin kendi kanalında aldığı belge kabulünü kaydeder. Konu yalnız\nhukuki belgedir (`subject_type = document`; rıza amaçları GA+1); `state` `presented`, `accepted` ya da `declined`\nolur. Sürüm, içerik özeti ve dil belgeden alınır, istemci veremez. `occurred_at` verilmezse sunucu anıdır;\nverilirse gelecekte ya da 5 dakikadan eski olamaz (eski kayıtların göçü `POST /v1/jobs/consent-imports` işidir).\nKayıt salt eklemelidir: güncellenmez ve silinmez. Kullanıcı ya da `application_id` ortamda yoksa `404 not_found`;\n`resource` uzantısı eksik olanı söyler (`user` ya da `application`). Belge yoksa `422` (`/subject_id`, kod\n`unknown_subject`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "consent-records" ], "raw": "{{baseUrl}}/users/:user_id/consent-records", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/consents", "request": { "description": "Kullanıcının uygulamalara verdiği etkin OAuth onaylarını en yeni verilen önce imleçli listeler; geri alınmış ve yerine yenisi geçmiş onaylar gelmez. Yalnız ileri sayfalama vardır (`before` ve `order=asc` 422). İmleç kullanıcıya bağlıdır. Kullanıcı bu ortamda yoksa 404 döner. Gösterilen onay metninin özeti dönmez; toplam sayı döndürülmez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "consents" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" } ], "raw": "{{baseUrl}}/users/:user_id/consents", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "DELETE /v1/users/{user_id}/consents/{consent_id}", "request": { "description": "Kullanıcının bir uygulamaya verdiği OAuth onayını geri alır: kullanıcının o uygulamadaki refresh token aileleri iptal edilir, onaydan önce verilmiş access token'lar artık kabul edilmez ve uygulamanın sonraki token isteği onayı yeniden ister. Onay yoksa, bu kullanıcının değilse ya da zaten geri alınmışsa 404 döner. Geri alma yönetim audit'ine `consent.revoked` olarak yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "consents", ":consent_id" ], "raw": "{{baseUrl}}/users/:user_id/consents/:consent_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" }, { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "consent_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/effective-permissions", "request": { "description": "Kullanıcının hesaplanmış etkin izinlerini döndürür (destek ve hata ayıklama): doğrudan ortam rollerinden ve `org_id`\nverilirse o org'daki etkin (`active`) üyeliğinin rollerinden gelen izinler, her izin için onu veren roller (`role_ids`).\n`api_id` sonucu bir API'ye daraltır (bilinmeyen API boş liste verir); silinmiş API'lerin izinleri dahil değildir.\nBilinmeyen kullanıcı ya da bu ortamda olmayan `org_id` `404`'tür. Liste sayfalanmaz (API'ye, sonra izin değerine göre\nsıralı).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "effective-permissions" ], "query": [ { "description": "Verilirse kullanıcının bu org'daki etkin üyeliğinin rolleri de hesaba katılır; org bu ortamda yoksa `404`.", "disabled": true, "key": "org_id", "value": "" }, { "description": "Sonucu bir API'nin izinlerine daraltır.", "disabled": true, "key": "api_id", "value": "" } ], "raw": "{{baseUrl}}/users/:user_id/effective-permissions", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/emails", "request": { "description": "Kullanıcının bütün e-posta adreslerini döndürür: önce birincil, sonra oluşturma sırası. Kullanıcı başına en çok 10 adres (birincil dahil) olduğundan liste imleçsizdir: `limit`, `after`, `before`, `order` yoktur ve `list_metadata` her zaman `null` değerlidir. Kimlik bilgisi `users:read_pii` iznini taşımıyorsa adresler maskeli döner. Kullanıcı bu ortamda yoksa, silinmekteyse ya da biçimsizse 404 döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "emails" ], "raw": "{{baseUrl}}/users/:user_id/emails", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "POST /v1/users/{user_id}/emails", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kullanıcıya birincil olmayan, doğrulanmamış bir ek e-posta adresi ekler (`201`, `UserEmail`). Adres normalleştirilir (büyük-küçük harf ve boşluk farkı aynı adrestir). Aynı adres kullanıcıda zaten varsa yeni satır yazılmaz ve mevcut satır döner (doğrulanmış ya da birincil olabilir). Başka bir kullanıcıda doğrulanmış adres `409 conflict` (`errors[]`: `/email`, `email_taken`), kullanıcı başına 10 adres sınırı doluysa `409 email_limit_reached` döner. Yeni satır `user.email_added` yönetim audit kaydı alır (aktör isteğin anahtarı; adres kayda yazılmaz). Doğrulama için `POST /v1/users/{user_id}/emails/{email_id}:send-verification` ya da `:verify` kullanılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "emails" ], "raw": "{{baseUrl}}/users/:user_id/emails", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "DELETE /v1/users/{user_id}/emails/{email_id}", "request": { "description": "Kullanıcının birincil olmayan bir e-posta adresini siler. Birincil adres silinemez (`409 primary_identifier_required`; önce başka bir doğrulanmış adres birincil yapılır); ortam e-postayı zorunlu tutarken son doğrulanmış adres silinemez (`409 last_verified_channel`). Adres bu kullanıcının değilse, bilinmiyorsa ya da kimlik biçimsizse `404` döner; aynı silme yinelenirse satır artık olmadığından yine `404` döner. Her silme `user.email_removed` yönetim audit kaydı alır; doğrulanmış adresin silinmesi `user.updated` olayını tetikler. Gövde alınmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "emails", ":email_id" ], "raw": "{{baseUrl}}/users/:user_id/emails/:email_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" }, { "description": "E-posta satırının kimliği: dahili UUID (küçük harf, tireli; planda e-posta öneki yok). Biçimsiz kimlik `404` döner.", "key": "email_id", "value": "" } ] } } }, { "name": "POST /v1/users/{user_id}/emails/{email_id}:send-verification", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kullanıcının belirtilen e-posta satırına doğrulama e-postası gönderir. `email_id` dahili UUID biçimindedir (küçük harf, tireli). E-posta satırı bu kullanıcının değilse 404, e-posta zaten doğrulanmışsa 409 döner. Kullanıcıya gönderim sınırı aşılırsa 429 ve `Retry-After`. Yanıt doğrulama isteğinin son kullanma zamanını taşır; kod ya da bağlantı dönmez.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "emails", "{{email_id}}:send-verification" ], "raw": "{{baseUrl}}/users/:user_id/emails/{{email_id}}:send-verification", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "POST /v1/users/{user_id}/emails/{email_id}:set-primary", "request": { "description": "Kullanıcının doğrulanmış bir adresini birincil yapar; önceki birincil ek adres olarak kalır. Doğrulanmamış adres birincil yapılamaz (`409 primary_requires_verified`). Adres zaten birincilse hiçbir şey yazılmaz ve `200` döner. Değişiklik `user.primary_email_changed` yönetim audit kaydı ve `user.updated` olayı alır. Gövde yoktur (boş ya da `{}`). Yanıt güncel `UserEmail` nesnesidir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "emails", "{{email_id}}:set-primary" ], "raw": "{{baseUrl}}/users/:user_id/emails/{{email_id}}:set-primary", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "POST /v1/users/{user_id}/emails/{email_id}:verify", "request": { "description": "Yöneticinin doğrulanmış işaretlemesidir: adres doğrulanmış olur ve doğrulama yöntemi `admin_api` saklanır (kullanıcıya kod ya da bağlantı gitmez; sahiplik kanıtı değildir). Adres zaten doğrulanmışsa hiçbir şey yazılmaz ve `200` döner. Aynı adresin başka hesaplardaki doğrulanmamış kopyaları silinir. Değişiklik `user.email_verified` yönetim audit kaydı (aktör isteğin anahtarı) ve `user.updated` olayı alır. Gövde yoktur (boş ya da `{}`). Yanıt güncel `UserEmail` nesnesidir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "emails", "{{email_id}}:verify" ], "raw": "{{baseUrl}}/users/:user_id/emails/{{email_id}}:verify", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/identities", "request": { "description": "Kullanıcının bağlı kimliklerini (parola, sosyal, SAML, OIDC ve legacy) tek sayfada, oluşturma zamanına göre sıralı listeler. Kullanıcı başına kimlik sayısı sınırlı olduğundan liste imleçsizdir: `limit`, `after`, `before`, `order` yoktur ve `list_metadata` her zaman `null` değerlidir. Kimliğin dış öznesi (OIDC `sub`, SAML NameID), IdP'nin bildirdiği e-posta ve kimlik bilgisi referansı hiçbir durumda dönmez. Passkey ve tek kullanımlık kod yöntemleri doğrulayıcıdır ve `GET /v1/users/{user_id}/authenticators` altında listelenir. Kullanıcı bu ortamda yoksa 404 döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "identities" ], "raw": "{{baseUrl}}/users/:user_id/identities", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "POST /v1/users/{user_id}/identities", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Federe bir kimliği (sosyal, SAML ya da OIDC bağlantısının dış öznesi) kullanıcıya bağlar; `linked_via` her zaman `admin_api` olur. Bağlantı bu ortamın, kimlik türüyle uyumlu etkin bağlantısı olmalıdır; değilse `422` (`errors[]`: `/connection_id`, `connection_unavailable`). Aynı kimlik bu ya da başka bir kullanıcıya zaten bağlıysa `409 conflict` (`errors[]`: `identity_already_linked`; sahibi söylenmez); kullanıcı başına kimlik sınırı doluysa `409 conflict` (`identity_limit_reached`). Dış özne kişisel veridir: hiçbir yanıtta ve audit kaydında dönmez. Bağlama, `user.identity_linked` yönetim audit kaydı (aktör isteğin anahtarı) ve olay tek işlemde yazılır. İki kullanıcıyı birleştirme (`source_user_id`) bu sürümde yoktur; bilinmeyen alan `400 unknown_field` döner. Yanıt yeni kimliktir (`201`, `UserIdentity`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "identities" ], "raw": "{{baseUrl}}/users/:user_id/identities", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "DELETE /v1/users/{user_id}/identities/{identity_id}", "request": { "description": "Kullanıcının bağlı bir kimliğini (parola, sosyal, SAML, OIDC ya da legacy) kaldırır. Kullanıcının üyesi olduğu bir org bu kimliğin bağlantısıyla SSO zorlasa da kaldırma yapılır: son kullanıcı bu kimliği hesap portalından kaldıramaz (`409 sso_enforced_by_organization`), müşteri bu uçla kaldırır. Kullanıcının son birinci faktör yöntemi kaldırılamaz (`409 last_login_method`). Kullanıcı bu ortamda yoksa, kimlik bu kullanıcının değilse ya da bilinmiyorsa aynı `404 not_found` döner; biçimsiz kullanıcı ya da `idn_` kimliği de 404'tür. Kaldırma, `user.identity_unlinked` yönetim audit kaydı (aktör isteğin anahtarı) ve `user.identity_unlinked` olayı tek işlemde yazılır; kullanıcının doğrulanmış adreslerine bildirim gider. Gövde alınmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "identities", ":identity_id" ], "raw": "{{baseUrl}}/users/:user_id/identities/:identity_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" }, { "description": "Bağlı kimliğin `idn_` önekli dış kimliği.", "key": "identity_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/logs", "request": { "description": "Tek kullanıcının ortam loglarını imleçli listeler (pano \"Kullanıcı → Etkinlik\" görünümü); süzgeçler `from`, `to`, `type` ve `org_id`, sıralama her zaman `occurred_at` azalandır. Kurallar `GET /v1/logs` ile aynıdır: saklama penceresi sunucuda uygulanır, pencere dışı `from` `400 range_outside_retention` döner. Biçimsiz kullanıcı kimliği `404 not_found` döner; kaydı olmayan kullanıcı boş liste alır. Org kapsamı: `org_id` verilirse kimlik bilgisi ek olarak `organizations:read` iznini taşımalıdır (yoksa `403 insufficient_permissions`); kullanıcı o org'un üyesi değilse (`invited`, `active` ya da `suspended` üyeliği yoksa) `404 not_found` döner; üyeyse yalnız o org bağlamında gerçekleşmiş (`org_id`'si o org olan) kayıtlar döner, kullanıcının org dışı ya da başka org bağlamındaki kayıtları dönmez. Görünürlük: `ip`, `ip_asn`, `user_agent` ve `user_agent_family` yalnız kimlik bilgisi `audit-events:read_ip` iznini taşıyorsa, `identifier_hint` yalnız `users:read_pii` iznini taşıyorsa yanıtta bulunur; izin yoksa alan hiç yazılmaz (maskeli değer dönmez). `ip_country` her zaman döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "logs" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "description": "Dahil alt sınır (RFC 3339). Yoksa saklama penceresinin başı; pencere dışı değer `400 range_outside_retention` döner.", "disabled": true, "key": "from", "value": "" }, { "description": "Hariç üst sınır (RFC 3339). Yoksa şimdi; `from` verilmişse ondan sonra olmalıdır.", "disabled": true, "key": "to", "value": "" }, { "description": "Log türü önekleri (`authentication.`, `session.created` gibi); parametre tekrarlanarak en çok 20 değer verilir, değerlerden birine uyan kayıtlar döner.", "disabled": true, "key": "type", "value": "" }, { "description": "Organizasyon (`org_` önekli dış kimlik).", "disabled": true, "key": "org_id", "value": "" } ], "raw": "{{baseUrl}}/users/:user_id/logs", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/memberships", "request": { "description": "Kullanıcının org üyeliklerini org kimliği sırasıyla (artan) imleçli listeler; yalnız ileri sayfalama vardır (`before`\nve `asc` dışı `order` `422`). Kaldırılmış üyelikler tavansız biriktiği için liste sayfalıdır.\n`status` verilmezse `invited`, `active` ve `suspended` döner; kaldırılmış üyelikler yalnız `status=removed` ile. İmleç\nkullanıcıya ve `status` süzgecine bağlıdır; başka listenin imleci `400 invalid_cursor`'dır. Bilinmeyen kullanıcı\n`404`'tür.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "memberships" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Üyelik durumu süzgeci.", "disabled": true, "key": "status", "value": "" } ], "raw": "{{baseUrl}}/users/:user_id/memberships", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/roles", "request": { "description": "Kullanıcının doğrudan ortam rollerini döndürür (org üyeliği rolleri dahil değildir; onlar için\n`GET /v1/organizations/{org_id}/memberships/{membership_id}`). Bilinmeyen kullanıcı `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "roles" ], "raw": "{{baseUrl}}/users/:user_id/roles", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "PUT /v1/users/{user_id}/roles", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kullanıcının doğrudan ortam rollerini tam küme olarak değiştirir (`role_ids`, en çok 50; boş dizi hepsini kaldırır).\nOrg rolü doğrudan atanamaz (`403 role_not_assignable`; org rolleri üyelik üzerinden atanır), bilinmeyen rol\n`422 unknown_role`. Aynı küme tekrar yazılırsa değişiklik ve olay yazılmaz. Değişiklik refresh ailelerine\n`roles_changed` işareti koyar ve yönetim audit'ine `user.updated` (`change=roles`) olarak düşer.\nKümede ayrıcalıklı (`is_privileged`) rol varsa (yeni eklenen ya da korunan) `users:write`'a ek olarak `roles:write` gerekir; yoksa `403 insufficient_permissions` (`required_permissions`: iki izin) ve yazma olmaz. Ayrıcalıklı rolü kümeden çıkarmak yalnız `users:write` ister.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "roles" ], "raw": "{{baseUrl}}/users/:user_id/roles", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/sessions", "request": { "description": "Kullanıcının oturumlarını tek sayfada listeler: son görülme zamanına göre yeniden eskiye, en çok 1.000. Liste imleçsizdir: `limit`, `after`, `before`, `order` yoktur ve `list_metadata` her zaman `null` değerlidir. Varsayılan yalnız etkin oturumlardır; `include_inactive=true` süresi dolmuş ve iptal edilmiş oturumları da (saklama süresi içinde) getirir. Kullanıcı bu ortamda yoksa 404 döner. Tam IP adresi görünür ve her görüntüleme yönetim audit'ine yazılır. Çerez, token ya da cihaz parmak izi dönmez. Org kapsamı: `org_id` verilirse kimlik bilgisi ek olarak `organizations:read` iznini taşımalıdır (yoksa `403 insufficient_permissions`); kullanıcı o org'un üyesi değilse `404 not_found` döner; üyeyse yalnız o org'un politikasıyla açılmış (`org_id`'si o org olan) oturumlar döner, kullanıcının başka org bağlamındaki ya da org'suz oturumları dönmez; `ip_address` ve `user_agent` `null` yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "sessions" ], "query": [ { "description": "Org kapsamı: `org_` önekli dış kimlik. Verilirse ek izin `organizations:read` gerekir ve yalnız o org bağlamındaki kayıtlar döner; kullanıcı org'un üyesi değilse `404`.", "disabled": true, "key": "org_id", "value": "" }, { "description": "`true` ise süresi dolmuş ve iptal edilmiş oturumlar da döner.", "disabled": true, "key": "include_inactive", "value": "" } ], "raw": "{{baseUrl}}/users/:user_id/sessions", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "POST /v1/users/{user_id}/sessions:revoke", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kullanıcının oturumlarını ve bağlı refresh token ailelerini iptal eder. Gövdesiz ya da boş gövde kullanıcının tüm oturumlarını kapatır. En çok bir süzgeç verilir: `session_id` yalnız o oturumu (kullanıcının değilse 404), `org_id` o org bağlamındaki oturumları ve org aileleri, `client_id` (`app_…`) yalnız o uygulamanın bu kullanıcıdaki refresh ailelerini (oturumlar açık kalır) iptal eder. Bu ortamda olmayan `org_id` ya da `client_id` 422 döner. Zaten iptal edilmiş oturumlar sayılmaz; tekrar çağrı başarıdır. İptal yönetim audit'ine yazılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "sessions:revoke" ], "raw": "{{baseUrl}}/users/:user_id/sessions:revoke", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "GET /v1/users/{user_id}/sign-in-state", "request": { "description": "Kullanıcının giriş durumunu döner: açık ve süresi dolmamış hesap kilitleri (yol başına en çok bir; `locked`, en geç biten kilidin `locked_until` değeri), penceresi sürmekte olan yol başına başarısızlık sayaçları (son başarıdan ya da son kilitten beri) ve saklamadaki oturumlardan son başarılı kimlik doğrulama (`authenticated_at`, `amr`, oturumun son bilinen ülkesi). Saklamada oturum yoksa (hiç giriş yok ya da son oturum 30 günden önce bitti) `last_sign_in` `null` döner. Salt okumadır; kilit kaldırma `POST /v1/users/{user_id}:unlock` ile yapılır. Yanıt sayaç öznesi, adres, IP, cihaz ya da oturum kimliği taşımaz. Kullanıcı bu ortamda yoksa `404`. Org kapsamı: `org_id` verilirse kimlik bilgisi ek olarak `organizations:read` iznini taşımalıdır (yoksa `403 insufficient_permissions`); kullanıcı o org'un üyesi değilse `404 not_found` döner; üyeyse `last_sign_in` yalnız o org bağlamındaki oturumlardan gelir, başarısızlık sayaçları hiçbir org'a atfedilmediğinden `failures` her zaman boş dizidir; kilitler hesabın her bağlamdaki girişini durdurduğu için döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id", "sign-in-state" ], "query": [ { "description": "Org kapsamı: `org_` önekli dış kimlik. Verilirse ek izin `organizations:read` gerekir ve yalnız o org bağlamındaki kayıtlar döner; kullanıcı org'un üyesi değilse `404`.", "disabled": true, "key": "org_id", "value": "" } ], "raw": "{{baseUrl}}/users/:user_id/sign-in-state", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "user_id", "value": "" } ] } } }, { "name": "POST /v1/users/{user_id}:block", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kullanıcıyı müşteri engeliyle (`source = admin_api`) engeller; durum `blocked` olur. Zaten engelliyse işlem değişiklik yapmadan başarılıdır. Silinmekte olan kullanıcı engellenemez. Oturumların iptali asenkron yürür.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", "{{user_id}}:block" ], "raw": "{{baseUrl}}/users/{{user_id}}:block" } } }, { "name": "POST /v1/users/{user_id}:cancel-deletion", "request": { "description": "Bekleme süresindeki silmeyi iptal eder. Açık bir engel varsa kullanıcı `blocked`, yoksa `active` olur. Silinmekte olmayan kullanıcıda etkisizdir ve kullanıcıyı döndürür. Silme vadesi geldiyse silme düzenleyicinindir ve `409` (`conflict=deletion_due`) döner. Gövde alınmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", "{{user_id}}:cancel-deletion" ], "raw": "{{baseUrl}}/users/{{user_id}}:cancel-deletion" } } }, { "name": "POST /v1/users/{user_id}:export", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kullanıcının kişisel verisinin dışa aktarma işini başlatır. Yanıt `202` ile iş nesnesidir; durum `GET /v1/jobs/user-exports/{job_id}` ile izlenir, tamamlanan paket `GET /v1/jobs/user-exports/{job_id}/download` ile indirilir. Paket bir ZIP dosyasıdır: `manifest.json` (dosya başına SHA-256 ve kayıt sayısı), profil, e-posta ve telefonlar, `user_metadata` ve `app_metadata`, bağlı kimlikler, doğrulayıcılar, oturumlar, organizasyon üyelikleri, OAuth onayları, rıza kayıtları ve kimlik doğrulama olayları (`auth_events.ndjson`). Parola özeti, TOTP tohumu, kurtarma kodları, oturum token'ları ve ham SAML/ID token pakete girmez. Paket 7 gün saklanır. Oturum ve olay IP adresleri yalnız `include_ip: true` ile girer ve bu `audit-events:read_ip` iznini de ister (yoksa `403 insufficient_permissions`). Ortamda aynı anda en çok 20 iş kuyrukta ya da çalışır durumda olabilir; aşımda `429 rate_limited` ve `Retry-After`. `Idempotency-Key` isteğe bağlıdır: aynı kimlik bilgisi ve aynı anahtar aynı işi döndürür (`Idempotent-Replayed: true`), aynı anahtar başka bir istekle `422 idempotency_key_reuse` döner. Kullanıcı bu ortamda yoksa ya da kimlik biçimsizse `404`. Son kullanıcıya e-posta gönderilmez; paket yönetim API'si dışa aktarmasında müşterinin sorumluluğundadır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", "{{user_id}}:export" ], "raw": "{{baseUrl}}/users/{{user_id}}:export" } } }, { "name": "POST /v1/users/{user_id}:force-password-reset", "request": { "description": "Kullanıcının parolasını sıfırlamaya zorlar: kullanıcı sonraki başarılı parola girişinde yeni parola belirlemeden devam edemez (`password_reset_required`). Parola özeti silinmez. Kullanıcının parolası yoksa `409` döner. Kullanıcı bu ortamda yoksa (başka ortamın kullanıcısı dahil) `404` döner. Gövde alınmaz (boş gövde ya da `{}`). Tekrarlanabilir: işaret zaten varsa ilk işaretin zamanı korunur. Yönetim audit'ine `user.password_reset_forced` yazılır ve müşteri olayı `password_reset.scheduled` üretilir. `user-credentials:write` izni gerekir; pano kullanıcısı için adım yükseltme ister.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", "{{user_id}}:force-password-reset" ], "raw": "{{baseUrl}}/users/{{user_id}}:force-password-reset" } } }, { "name": "POST /v1/users/{user_id}:impersonate", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "İskelet işlem; davranış plan satırındadır. Not: izin planda yazılmamış", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", "{{user_id}}:impersonate" ], "raw": "{{baseUrl}}/users/{{user_id}}:impersonate" } } }, { "name": "POST /v1/users/{user_id}:send-password-reset", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kullanıcının birincil e-postasına parola sıfırlama bağlantısını gönderir (bağlantı ömrü 24 saat). Adres istekte verilmez; bağlantı yanıtta dönmez. Birincil e-posta yoksa ya da doğrulanmamışsa 409 döner; kullanıcıya gönderim sınırı aşılırsa 429 ve `Retry-After`. Gövde isteğe bağlıdır: `locale` e-posta dilini seçer, boşsa kullanıcının ya da ortamın dili kullanılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", "{{user_id}}:send-password-reset" ], "raw": "{{baseUrl}}/users/{{user_id}}:send-password-reset" } } }, { "name": "POST /v1/users/{user_id}:send-verification-email", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kullanıcının birincil e-postasına doğrulama e-postası gönderir. E-posta zaten doğrulanmışsa ya da birincil e-posta yoksa 409 döner. Kullanıcıya gönderim sınırı aşılırsa 429 ve `Retry-After`. Yanıt doğrulama isteğinin son kullanma zamanını taşır; kod ya da bağlantı dönmez. Belirli bir e-posta satırı için `/v1/users/{user_id}/emails/{email_id}:send-verification` kullanılır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", "{{user_id}}:send-verification-email" ], "raw": "{{baseUrl}}/users/{{user_id}}:send-verification-email" } } }, { "name": "POST /v1/users/{user_id}:start-recovery", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Beklemesiz hesap kurtarma bağlantısını kullanıcının birincil e-postasına gönderir (ömür 24 saat); `admin_only` kipin yoludur. İstek doğrudan `ready` açılır, açık bir kurtarma isteği aynı işlemde değiştirilir (`superseded`). Ortamda hesap kurtarma `disabled` ise ya da birincil e-posta yoksa 409 döner. Bağlantı yanıtta dönmez; yanıt isteğin kimliğini ve son kullanma zamanını taşır.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", "{{user_id}}:start-recovery" ], "raw": "{{baseUrl}}/users/{{user_id}}:start-recovery" } } }, { "name": "POST /v1/users/{user_id}:unblock", "request": { "description": "Müşteri engellerini kaldırır. Platform ya da dizin tarafından konmuş bir engel açıksa kullanıcı `blocked` durumunda kalır. Gövde alınmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", "{{user_id}}:unblock" ], "raw": "{{baseUrl}}/users/{{user_id}}:unblock" } } }, { "name": "POST /v1/users/{user_id}:unlock", "request": { "description": "Kullanıcının bütün kimlik doğrulama yollarındaki açık ve süresi dolmamış kaba kuvvet kilitlerini kapatır: kilit `cleared_by = admin:` ile kapanır, yolların sayaçları silinir, her kilit için `user.unlocked` olayı ve kilit kapandıysa tek yönetim audit kaydı (`user.unlocked`) yazılır. Kilidi olmayan kullanıcıda `unlocked: 0` döner ve hiçbir şey yazılmaz; işlem doğası gereği idempotenttir. Aktör yalnız doğrulanmış kimlik bilgisinden gelir. Kullanıcı yoksa `404`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Idempotency-Key", "value": "{{$guid}}" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users", "{{user_id}}:unlock" ], "raw": "{{baseUrl}}/users/{{user_id}}:unlock" } } }, { "name": "POST /v1/users:search", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Kişisel veri içeren süzgeçlerle (tam e-posta, E.164 telefon, kullanıcı adı, e-posta alan adı, meta veri eşitliği) kullanıcı arar; süzgeçler yalnız gövdede kabul edilir, sorgu dizisinde edilmez. Süzgeçler VE ile birleşir ve en az bir kimlik süzgeci gerekir. Arama çok geniş kalırsa `search_too_broad` döner. Sayfalama parametreleri sorgu dizisindedir (`limit`, `after`, `before`, `order`); bunlar kişisel veri taşımaz. Kimlik bilgisi `users:read_pii` iznini taşımıyorsa yanıttaki kişisel veri maskelenir: `email` `a***@e***.com` biçiminde, `phone_number` son 2 hane dışında `*`, `name`, `given_name`, `family_name`, `middle_name` ve `nickname` baş harfler, `username` ilk karakter ve `***`, `birthdate` `****-**-**`, `address` `{\"redacted\": true}` olur; `user_metadata` ve `app_metadata` maskelenmez. Bu izni taşımayan kimlik bilgisi de kişisel veri süzgeçleriyle (tam eşleşme) arayabilir; sonuç maskeli döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "users:search" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/users:search" } } } ], "name": "users" }, { "description": "`/v1/webhook-endpoints` kaynak ailesi.", "item": [ { "name": "GET /v1/webhook-endpoints", "request": { "description": "Ortamın web kancası uçlarını imleçli sayfalarla döndürür; varsayılan sıra yeniden eskiye, `order=asc`\neskiden yeniye. Yanıt imza sırrı taşımaz. Plan kapısı yoktur; ortam başına etkin uç sınırı: Free 3 · Startup 20 · Business 20 · Enterprise 50.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "webhook-endpoints" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" } ], "raw": "{{baseUrl}}/webhook-endpoints" } } }, { "name": "POST /v1/webhook-endpoints", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ortama bir web kancası ucu ekler. `url` zorunludur: yalnız `https`, port yok ya da 443, kullanıcı bilgisi\nve parça yok, IP değişmezi yok, en çok 2.048 karakter (`422 /url invalid_webhook_url`). `event_types` boşsa yüksek hacimli\ntürler dışındaki bütün katalog türleri seçilir. Yanıt `idp_whsec_` önekli imza sırrını (`signing_secret`) yalnız bir kez\ntaşır (`Cache-Control: no-store`); `Idempotency-Key` tekrarında sır dönmez, `secret_redacted: true` döner. Ortam başına etkin uç sınırı: Free 3 · Startup 20 · Business 20 · Enterprise 50.\nAşım ya da plan kodu bilinmeyen ortam `403 quota_exceeded`; `key` ortamda başka uçtaysa `409 conflict`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "webhook-endpoints" ], "raw": "{{baseUrl}}/webhook-endpoints" } } }, { "name": "GET /v1/webhook-endpoints/{endpoint_id}", "request": { "description": "Tek web kancası ucunu döndürür; `ETag` uç sürümüdür ve güncelleme ile silmede `If-Match` değeridir. Başka ortamın ucu ve\nbiçimsiz kimlik `404 not_found`'dur. Yanıt imza sırrı taşımaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "webhook-endpoints", ":endpoint_id" ], "raw": "{{baseUrl}}/webhook-endpoints/:endpoint_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "endpoint_id", "value": "" } ] } } }, { "name": "DELETE /v1/webhook-endpoints/{endpoint_id}", "request": { "description": "Ucu siler; bekleyen ve yeniden denenen teslimleri aynı işlemde `cancelled` olur, teslim geçmişi saklama süresince (30 gün)\nkalır. `If-Match` zorunludur (`*` her sürümle eşleşir); okuma ile silme arasında değişen uç `412`'dir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" } ], "method": "DELETE", "url": { "host": [ "{{baseUrl}}" ], "path": [ "webhook-endpoints", ":endpoint_id" ], "raw": "{{baseUrl}}/webhook-endpoints/:endpoint_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "endpoint_id", "value": "" } ] } } }, { "name": "PATCH /v1/webhook-endpoints/{endpoint_id}", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Ucu JSON Merge Patch (RFC 7396) ile değiştirir; `If-Match` zorunludur (yoksa `428`, eşleşmezse `412`). `status` yalnız\n`enabled` ya da `disabled_by_user` yazılır; `enabled` etkin uç sınırına sayılır (aşım `403 quota_exceeded`) ve\n`failing_since`'i siler: kapanmış uç böyle yeniden açılır, kapalı dönemdeki olaylar `:replay` ile alınır. `null` yalnız\n`description` ve `event_schema_versions`'ı temizler; diğer alanlarda `422 invalid`. Değişiklik yoksa yazılmaz, sürüm artmaz.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yapılandırma kaynağında zorunlu; yoksa 428, eşleşmezse 412.", "key": "If-Match", "value": "" }, { "key": "Content-Type", "value": "application/merge-patch+json" } ], "method": "PATCH", "url": { "host": [ "{{baseUrl}}" ], "path": [ "webhook-endpoints", ":endpoint_id" ], "raw": "{{baseUrl}}/webhook-endpoints/:endpoint_id", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "endpoint_id", "value": "" } ] } } }, { "name": "GET /v1/webhook-endpoints/{endpoint_id}/deliveries", "request": { "description": "Ucun son 30 günlük teslim geçmişini imleçli sayfalarla döndürür (varsayılan yeniden eskiye, `order=asc` eskiden yeniye);\n`status` ve `event_type` ile süzülür, imleç süzgeçlere bağlıdır. Yalnız meta veri döner: yük gövdesi ve alıcı yanıtı yoktur.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" } ], "method": "GET", "url": { "host": [ "{{baseUrl}}" ], "path": [ "webhook-endpoints", ":endpoint_id", "deliveries" ], "query": [ { "disabled": true, "key": "limit", "value": "" }, { "description": "Opak imleç; `before` ile birlikte kullanılamaz.", "disabled": true, "key": "after", "value": "" }, { "description": "Opak imleç; `after` ile birlikte kullanılamaz.", "disabled": true, "key": "before", "value": "" }, { "disabled": true, "key": "order", "value": "" }, { "description": "Teslim durumuna göre süz.", "disabled": true, "key": "status", "value": "" }, { "description": "Olay türüne göre süz.", "disabled": true, "key": "event_type", "value": "" } ], "raw": "{{baseUrl}}/webhook-endpoints/:endpoint_id/deliveries", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "endpoint_id", "value": "" } ] } } }, { "name": "POST /v1/webhook-endpoints/{endpoint_id}/deliveries/{delivery_id}:retry", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "`succeeded` ya da `abandoned` durumundaki bir teslimi (son 30 gün) aynı olayla yeni bir teslim olarak hemen kuyruğa alır\n(`replay_no` + 1, `webhook-id` aynı) ve yeni teslimi döndürür. Bekleyen ya da yeniden denenen teslim ve etkin olmayan uç\n`409 conflict`; başka ucun ya da ortamın teslimi `404`. Gövde isteğe bağlıdır; verilirse boş nesnedir.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "webhook-endpoints", ":endpoint_id", "deliveries", "{{delivery_id}}:retry" ], "raw": "{{baseUrl}}/webhook-endpoints/:endpoint_id/deliveries/{{delivery_id}}:retry", "variable": [ { "description": "Önekli dış kimlik ya da plan satırındaki anahtar.", "key": "endpoint_id", "value": "" } ] } } }, { "name": "POST /v1/webhook-endpoints/{endpoint_id}:replay", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Son 30 gün içinde `[from, to)` aralığındaki olayları (`types` boşsa ucun türleri) yeniden kuyruğa alır; `replay_no` artar,\n`webhook-id` değişmez, alıcı yinelenen olayı kimliğiyle ayıklar. Aralık kuralları `422` döner. Hücrenin olay kaynağı henüz\nhizmet vermiyorsa `503` (`Retry-After`) döner.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "webhook-endpoints", "{{endpoint_id}}:replay" ], "raw": "{{baseUrl}}/webhook-endpoints/{{endpoint_id}}:replay" } } }, { "name": "POST /v1/webhook-endpoints/{endpoint_id}:rotate-secret", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Yeni imza sırrı üretir; sır yanıtta yalnız bir kez döner (`Cache-Control: no-store`; `Idempotency-Key` tekrarında\n`secret_redacted: true`). Eski sır `previous_secret_ttl_hours` (0–168, varsayılan 24) boyunca ikinci imza olarak kullanılır;\n`0` eski sırrı hemen düşürür. `If-Match` isteğe bağlıdır; verilirse uç sürümüyle eşleşmelidir (`412`).", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "İyimser eşzamanlılık; kullanıcı/üyelik kaynaklarında isteğe bağlı.", "disabled": true, "key": "If-Match", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "webhook-endpoints", "{{endpoint_id}}:rotate-secret" ], "raw": "{{baseUrl}}/webhook-endpoints/{{endpoint_id}}:rotate-secret" } } }, { "name": "POST /v1/webhook-endpoints/{endpoint_id}:test", "request": { "body": { "mode": "raw", "options": { "raw": { "language": "json" } }, "raw": "" }, "description": "Uca seçilen türde imzalı sentetik bir olay (`data.test = true`, varsayılan `user.created`) çıkış vekili üzerinden gönderir\nve sonucu döndürür; teslim kaydı açılmaz, alıcının gövdesi döndürülmez. Uç başına dakikada 10 deneme (`429`, `Retry-After`\nhooks'un bekleme süresi). Etkin olmayan uç `409 conflict`.", "header": [ { "description": "SDK telemetri başlığı `/ (<çalışma_zamanı>/)`; kimlik doğrulama değildir.", "disabled": true, "key": "Idp-Client", "value": "" }, { "description": "İstemcinin kendi istek kimliği, 1–128 yazdırılabilir ASCII.", "disabled": true, "key": "Idp-Client-Request-Id", "value": "" }, { "description": "Müşterinin iş akışı kimliği (UUID); ortam loguna, audit'e ve olaylara yazılır.", "disabled": true, "key": "Idp-Correlation-Id", "value": "" }, { "description": "Yan etkili POST için isteğe bağlı; 24 saat geçerli; aynı anahtar + farklı gövde → 422 idempotency_key_reuse.", "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "url": { "host": [ "{{baseUrl}}" ], "path": [ "webhook-endpoints", "{{endpoint_id}}:test" ], "raw": "{{baseUrl}}/webhook-endpoints/{{endpoint_id}}:test" } } } ], "name": "webhook-endpoints" } ], "variable": [ { "key": "apiKey", "type": "string", "value": "" }, { "key": "application_id", "type": "string", "value": "" }, { "key": "authenticator_id", "type": "string", "value": "" }, { "key": "baseUrl", "type": "string", "value": "https://api.{{region}}.keenauth.com/v1" }, { "key": "conflict_id", "type": "string", "value": "" }, { "key": "connection_id", "type": "string", "value": "" }, { "key": "custom_domain_id", "type": "string", "value": "" }, { "key": "delivery_id", "type": "string", "value": "" }, { "key": "directory_id", "type": "string", "value": "" }, { "key": "domain_id", "type": "string", "value": "" }, { "key": "email_id", "type": "string", "value": "" }, { "key": "endpoint_id", "type": "string", "value": "" }, { "key": "hold_id", "type": "string", "value": "" }, { "key": "hook_id", "type": "string", "value": "" }, { "key": "invitation_id", "type": "string", "value": "" }, { "key": "job_id", "type": "string", "value": "" }, { "key": "key_id", "type": "string", "value": "" }, { "key": "locale", "type": "string", "value": "" }, { "key": "log_stream_id", "type": "string", "value": "" }, { "key": "mapping_id", "type": "string", "value": "" }, { "key": "membership_id", "type": "string", "value": "" }, { "key": "org_id", "type": "string", "value": "" }, { "key": "plan_id", "type": "string", "value": "" }, { "key": "policy_kind", "type": "string", "value": "" }, { "key": "region", "type": "string", "value": "eu" }, { "key": "relationship_id", "type": "string", "value": "" }, { "key": "revision_id", "type": "string", "value": "" }, { "key": "sender_domain_id", "type": "string", "value": "" }, { "key": "session_id", "type": "string", "value": "" }, { "key": "user_id", "type": "string", "value": "" }, { "key": "version", "type": "string", "value": "" } ] }