PlagiarismSearch API: Entegrasyonla İlgili Sorular ve Cevaplar
API erişimi, eşzamansız intihal kontrolleri, geri çağırmalar, raporlar, özel depolama (Storage), filtreler ve yaygın entegrasyon sorunlarına yönelik pratik bir kılavuz.
Ekran görüntüleri daha önceki bir API iş akışını göstermektedir. Üretim entegrasyonlarını uygulamadan önce bağlantılı v3 belgelerini ve hesap ayarlarınızı kontrol edin.
PlagiarismSearch API'si neler yapabilir?
PlagiarismSearch RESTful API, geliştiricilerin benzerlik analizi için metin veya desteklenen dosyaları göndermelerine, sonuçları ve kaynak bilgilerini almalarına ve intihal kontrolünü bir kuruluşun kendi iş akışına bağlamalarına olanak tanır. Özel Depolama (Storage), müşterinin indekslemeyi seçtiği belgelerle karşılaştırmayı destekleyebilir.
API özellikleri ve izinleri hesaba ve etkinleştirilen hizmetlere bağlıdır. Bayi işlemlerinin, Storage'a yazma erişiminin veya yapay zeka ile üretilmiş metin tespitinin her hesapta mevcut olduğunu varsaymayın. Yapay zeka yazma sinyali, intihal veya benzerlik tespitinden ayrıdır.
API erişimini ve kimlik bilgilerini nasıl edinebilirim?
Öncelikle herkese açık Plagiarism API genel bakışı ve API dokümantasyonu ile başlayın. Deneme erişimi veya fiyatlandırma gerekiyorsa, güncel koşulları doğrulamak için services@plagiarismsearch.com adresiyle iletişime geçin. Eski belgelerde 30 günlük ve 100 gönderim hakkı içeren bir deneme sürümü açıklanmıştır; ancak bu hakların günümüzde yeni kayıtlara sağlandığı doğrulanmamıştır.
Mevcut bir hesabınız varsa API kullanıcı adınızı ve anahtarınızı incelemek için uygulamadaki onaylanmış API Credentials sayfasını kullanın. Kimlik bilgilerini sunucuda saklayın. Etkin anahtarları destek taleplerine, herkese açık kaynak koduna veya yalnızca tarayıcıda çalışan uygulamalara asla yapıştırmayın.
Asenkron raporlama iş akışı nasıl çalışır?
- reports/create üzerinden bir metin, dosya veya izin verilen herkese açık bir URL gönderin.
- Geri dönen rapor kimliğini kaydedin ve isteğin kabul edildiğini kontrol edin. Bakiye ve hesap izinleri işleme sürecini etkileyebilir.
- Sunucu, gönderilen içeriği eşzamansız olarak işler. İşlem süreleri, belge boyutuna, mevcut kaynaklara ve seçilen analiz seçeneklerine bağlı olarak değişir; kesin bir tamamlanma garantisine güvenmeyin.
- Yapılandırılan
callback_urladresinden bir tamamlama bildirimi alın veya uygun yerlerde belgelenmiş rapor durumu iş akışını kullanın. - Ayrıntıları ve mevcut rapor bağlantılarını reports/{id} kullanarak alın.
geri çağrı isteği referansına bakın. Uç noktanız HTTPS üzerinden erişilebilir olmalı, gelen istekleri mevcut entegrasyon sözleşmesine göre doğrulamalı ve yeniden denemeleri veya yinelenen bildirimleri güvenli bir şekilde ele almalıdır.
Rapor oluşturma isteği nasıl görünür?
Belgelenmiş oluşturma yöntemi POST'tur, PUT değil. Aşağıdaki örnek bir isteğin yapısını göstermektedir; sunucu tarafı API kullanıcı adınızı ve anahtarınızı kullanın ve belgelendirmede desteklenen parametreleri doğrulayın.
curl --request POST \
'https://plagiarismsearch.com/api/v3/reports/create' \
--user 'YOUR_API_USER:YOUR_API_KEY' \
--form 'text=Example document text for a similarity check.' \
--form 'search_web=1' \
--form 'search_storage=0' \
--form 'callback_url=https://your-domain.example/api/plagiarism-callback'Dosya gönderirken file form alanını kullanın. API dokümantasyonu ayrıca url, title, remote_id ve isteğe bağlı filtreleri de açıklamaktadır. Kimlik doğrulama bilgilerini sorgu dizelerine veya ekran görüntülerine dahil etmekten kaçının.
Dosya nasıl gönderilir ve rapor nasıl incelenir?
Tipik bir dosya gönderimi, belgelenmiş file alanını kullanır; tamamlanmış bir rapor GET /api/v3/reports/{id} aracılığıyla alınabilir. Bu iki ekran görüntüsü eski entegrasyon kılavuzundan alınmıştır ve mevcut API referansının yerine geçmekten ziyade açıklayıcı niteliktedir.


Kaynakları ve rapor detaylarını nasıl alabilirim?
v3 rapor görünümü uç noktası show_relations özelliğini destekler. Belgelenmiş değerler, ne kadar bilginin döndürüleceğini kontrol etmeye yardımcı olur:
0— temel rapor bilgileri (varsayılan).1— paragraflar, cümleler, kaynaklar ve vurgulanmış metin içeren yapılandırılmış rapor ağacı.-1— ham rapor ilişkileri.-2— kaynak eşleşmelerinin listesi.-3— Desteklenen yerlerde HTML rapor içeriği.
Örnek: GET https://plagiarismsearch.com/api/v3/reports/REPORT_ID?show_relations=-2. Eski, sabit kodlanmış rapor anahtarlarından URL'ler oluşturmak yerine, geçerli uç nokta referansındaki yanıt şemasını inceleyin.
Benzerlik puanları ve kaynak yüzdeleri, intihal tespiti için kanıt niteliğindedir, otomatik intihal belirlemesi değildir. İsteğe bağlı yapay zeka içerik alanları (varsa), farklı bir analizi temsil eder.
HTML ve PDF sonuçlarını indirebilir miyim?
Rapor yanıtları, tarayıcıdan erişilebilen bir HTML bağlantısı ve hesap izinleri ile API yanıtına bağlı olarak PDF sürümleri için files dizisinde girdiler içerebilir. Kimlikleri ve erişim anahtarlarını elle birleştirmek yerine ilgili rapor için döndürülen rapor URL’lerini tercih edin.
Rapor URL'lerini yetkilendirme anahtarlarıyla birlikte herkese açık olarak dizine eklenmiş sayfalarda veya günlüklerde ifşa etmeyin. Raporlara erişim ve bunların saklanması, geçerli hesap, paylaşım ve veri saklama kurallarına tabidir; her raporun sonsuza dek erişilebilir kalacağı yönündeki eski iddia kullanılmamalıdır. Bkz. benzerlik raporu yorumlama kılavuzu ve veri işleme bilgileri.
Hariç tutma ve arama filtreleri nasıl çalışır?
Oluşturma uç noktası, referans ve alıntı filtrelerini, Web ve Depolama (Storage) seçimini ve URL seçeneklerini belgeler. Örneğin, filter_references ve filter_quotes, referans listesi veya alıntı içeriğini hariç tutmak için belgelenmiş takma adlardır; search_web ve search_storage kaynak koleksiyonlarını seçer.
API dokümantasyonu search_web_disable_urls ile search_web_exclude_urls arasında ayrım yapar. İkincisi, seçilen siteleri hesaplanan puandan hariç tutarken eşleşen kanıtların görünür kalmasını sağlayabilir. Hariç tutmalar uygulandıktan sonra daha düşük bir puan, orijinal metnin değiştiği veya daha özgün hale geldiği anlamına gelmez.
Yorumlama için arama filtresi kılavuzunu kullanın. Yalnızca Latin harflerini içeren metinlere yönelik filtreleri etkinleştirmeden önce Latince olmayan ve çok dilli metin ayarlarını kontrol edin.
Özel depolama (Storage) alanına nasıl dosya yüklerim ve sorgularım?
Özel Depolama (Storage), önceden indekslenmiş seçili belgelerle karşılaştırma için isteğe bağlı, müşteri tarafından kontrol edilen bir koleksiyondur. Rapor geçmişinden farklıdır. Eski kılavuz, yükleme yolunu POST /api/v3/storage/create gösterir ve is_in_index durum alanına atıfta bulunur; bu işlemleri ve izinlerini hesabınızın mevcut API referansında doğrulayın.

Yalnızca işleme ve indeksleme yetkiniz olan belgeleri yükleyin. Bir belgeyi Depolama (Storage) alanına eklemek, yeni bir belgeyi benzerlik açısından kontrol etmekten farklıdır; iş akışı açıkça gerektirmediği sürece gönderilen her metni otomatik olarak kaydetmekten kaçının.
API, bayi ve çok kullanıcılı iş akışlarını destekliyor mu?
Eski dokümantasyon, müşteri kayıtları oluşturan ve bayiye özgü yollar üzerinden kontrol kaynakları tahsis eden bayi hesaplarını açıklar. Bu özellikler hesaba bağlıdır ve varsayılan olarak kullanılabilir diye sunulmamalıdır. Güncel bayi hakları, endpoint erişimi ve güvenli bir uygulama planı için services@plagiarismsearch.com adresiyle iletişime geçin.
Eski parola örneklerini asla üretim kalıpları olarak kullanmayın. Benzersiz kimlik bilgilerini güvenli bir şekilde oluşturun, ham parolaları günlük dosyalarına veya istemcilere döndürmekten kaçının ve müşteri oluşturma ve tahsis iş akışlarının hala eski /api/v3/reseller-customers arayüzünü kullanıp kullanmadığını doğrulayın.
Neden 400 hatası, kimlik doğrulama başarısızlığı veya beklemede olan sonuçlar alıyorum?
400 Bad Request
Öncelikle HTTP yöntemini kontrol edin: Belgelenmiş rapor oluşturma uç noktası POST yöntemini kullanır. Alan adlarını, içerik türünü, dosya boyutunu, gerekli metin alanlarını ve gerçek hata yanıtını doğrulayın; bir HTTP 400 hatasının birden fazla nedeni olabilir.

401 / authentication error
API kullanıcı adı ve anahtarının etkin olduğunu ve endpoint tarafından istenen kimlik doğrulama yöntemiyle her istekte gönderildiğini doğrulayın. Hesabınızdaki API Credentials sayfasına bakın. Gizli anahtarları herkese açık JavaScript koduna koymayın veya ekran görüntülerinde paylaşmayın.
Belge hâlâ işlenmeyi bekliyor.
Gönderilen rapor veya depolama (Storage) belgesi henüz hazır olmayabilir. Sabit 0-6 dakikalık bir tamamlama süresi varsaymak yerine, belgelenmiş rapor durumunu veya depolama indeksleme durumunu kontrol edin. Hataları ve yeniden denemeleri tamamlanmış raporlardan ayrı olarak ele alın.
Geliştiriciler bundan sonra nereye yönelmeli?
Yeni bir entegrasyon için, API dokümantasyonu ile başlayın, etkinleştirilmiş hesap özelliklerini doğrulayın, ardından gerçek metin ve özellikle farklı kaynaklarla küçük bir örnek üzerinde test yapın. Yalnızca saklanması güvenli olan teknik meta verileri kaydedin, API kimlik bilgilerini koruyun ve otomatik raporlar oluşturmadan önce döndürülen yanıtı belgelenmiş şemayla karşılaştırın.
Erişim veya kurulum soruları için services@plagiarismsearch.com adresine ulaşın veya Yardım Merkezini kullanın. Herkese açık İntihal API sayfası, ürün ve iletişim seçeneklerini açıklamaktadır.