Erişim talebi: eksik izni yöneticiden istemek
Uygulamanızın bir kuruluma, ERP sorgusuna, uygulama izni atamasına ya da yeni bir yetki alanına ihtiyacı olduğunda izni yöneticiden erişim talebiyle istersiniz. Talebi çoğu zaman yapay zeka aracınız sizin adınıza gönderir; komut satırından siz de gönderebilirsiniz.
⛔ Talep izni kendiliğinden vermez. Yönetici talebi Devoplus Console'da onaylar ya da gerekçesiyle reddeder; sonuç size e-postayla bildirilir.
Nasıl gönderilir
| Yol | Gönder | Durum |
|---|---|---|
| Yapay zeka aracınız | Devoplus One bağlantısı üzerinden, sizin oturumunuzla | Aynı bağlantıdan izler |
Komut satırı (@devoplus/one-sdk) | one login, ardından one request <tür> ... | one requests [kimlik] |
Kart gösterebilen bir ortamda (örneğin Claude'un web ve masaüstü uygulaması ya da ChatGPT) gönderilen talep, taleplerinizin listesi, yayın istekleri ve kullanım panosu sohbette Devoplus One görünümlü bir kart olarak da görünebilir. Claude Code gibi terminal araçları kart göstermez; orada aynı bilgi metin olarak gelir.
Portalınızda Devoplus One uygulamalarına açılmış ERP (DEXA) sorgularını, giriş parametreleri ve döndürdükleri sütunlarla one dexa queries listeler (yalnız okur, izin vermez); yapay zeka aracınız aynı listeyi bağlantı üzerinden görür ve sorgu talebinde anahtarı buradan alır.
Oturumdaki portalın adını ve var olan kısa adını (portal anahtarı) one context gösterir (yalnız okur). Talebi gönderen kişi ve portal oturumdan gelir; talepte portal ya da kişi bilgisi yoktur. Devoplus hesabınızla giriş yaparken portalı siz seçersiniz.
Türler
| Tür | Ne ister | Zorunlu alan | Kime düşer |
|---|---|---|---|
registration | Yeni uygulama kaydı (onaylanınca gönderen sahip olur) | titleTr (İngilizce ad ve additionalPermissions isteğe bağlı) | Şirket yöneticisi |
installation | Uygulamanın bir portala kurulması | Yok (portalKey isteğe bağlı) | Şirket yöneticisi |
dexa-query | ERP okuma sorgusunun uygulamaya açılması | queryKey | Şirket yöneticisi |
dexa-command | ERP'ye yazan işlemin uygulamaya açılması | queryKey | Şirket yöneticisi |
app-permission | Uygulama izninin bir kullanıcı grubuna atanması | permissionCode (ve ad, isteğe bağlı grup) | Şirket yöneticisi |
scope | Uygulamaya yeni bir yetki alanı | scope (<modül>.<read|write|manage|execute>) | Platform yöneticisi |
new-query | Henüz olmayan bir ERP sorgusu için iş talebi | description (ve isteğe bağlı draftSql) | Şirket yöneticisi |
Onaylayan, talebin portalının şirket yöneticisidir (küresel yönetici de onaylayabilir); yalnız yetki alanı (scope) talepleri platform yöneticisine düşer.
Her talepte appSlug (manifest app.slug) ve justification (yöneticinin okuyacağı kısa gerekçe, en çok 2.000 karakter) bulunur. Gerekçe iş diliyle yazılır: "Satış ekibi müşteri bakiyesini uygulamada görebilsin diye".
registration: uygulama içi izinler (roller) kayıt talebinde istenir: additionalPermissions = [{ code, nameTr, nameEn? }], en çok 16. Kod One.<Uygulama>.<Eylem> biçimindedir, ana iznin (One.<Uygulama>.Use) ad alanında olur ve ana kodun kendisi olamaz. Onayla birlikte izin kataloğuna girer. Kayıttan sonra izin eklemenin talep türü yoktur: izni uygulamanın ana portalının şirket yöneticisi Devoplus Console'dan ekler, sahip listesini de o değiştirir; ana portalı belirlenemeyen uygulamada bu ikisini platform yöneticisi yapar. Bu yüzden manifest permissions listesindeki bütün izinler kayıtta istenir. Komut satırında: one request registration --title "<ad>" --permission One.Hello.Manage="Yönetir" [--permission-en One.Hello.Manage="Manages"].
installation: portal anahtarını sunucu portalın adından belirler (örneğin "Süvari Portal" için suvari); elle seçilemez. portalKey gönderilirse yok sayılır.
app-permission: permissionCode uygulamanın kaydında (ana izin ya da kayıtta istenen ek izinler) tanımlı olmalıdır; değilse talep baştan reddedilir.
new-query: draftSql yalnız bir öneridir, hiçbir yerde çalıştırılmaz; yönetici sorguyu kendisi oluşturur ve onaylarken sorgu anahtarını yazar. Onaydan sonra talebin sonucundaki sorgu anahtarı manifest'e eklenir.
Kurallar ve hatalar
| Durum | Ne olur |
|---|---|
| Talebi gönderen uygulamanın sahibi değil (kayıt hariç) | 403 ONE-APP-E-039; talebi uygulamanın sahibi gönderir |
| Kısa ad zaten kayıtlı (kayıt talebi) | 409 ONE-APP-E-038; başka bir kısa ad seçin |
| Kısa ad pasife alınmış bir uygulamaya ait | 409 ONE-APP-E-107; bu kısa ad yeniden kaydedilemez, başka bir kısa ad seçin |
| Aynı talep zaten bekliyor | 409 ONE-APP-E-040; yeniden göndermeyin, durumunu izleyin |
| Kişi başına saatte 20 talep aşıldı | 429 ONE-APP-E-041 |
| İzin kodu uygulamanın ad alanında değil | 400 ONE-APP-E-047; kod One.<Uygulama>.<Eylem> biçiminde olmalı |
| Ek izin biçimsiz, ad alanı dışında, ana kodla aynı ya da yinelenen; 16'dan fazla | 400; listeyi düzeltip yeniden gönderin |
app-permission kodu uygulamanın kaydında yok | 400; izni önce uygulama kaydına ekletin (ana portalın şirket yöneticisi, Devoplus Console), sonra talebi yeniden gönderin |
| Oturumda portal yok | 403 ONE-APP-E-037; yeniden giriş yapıp portal seçin |
| Vekalet ya da Yerine Görüntüle oturumu | Talep gönderilmez; kendi oturumunuzla bağlanın |
Reddedilen bir talebin notu size e-postayla gelir; nota göre talebi düzeltip yeniden gönderebilirsiniz.