API ile bir belge doğrula
API anahtarını API-KEY başlığında tutarak VerifyPDF REST API'sine bir PDF gönder. Her doğrulama bir belge tüketir ve panelle aynı sonucu döndürür.
VerifyPDF REST API’si, kimsenin paneli açmasına gerek kalmadan kendi sistemlerinin belge doğrulamasını sağlar. Bu makale üst düzey akışı kapsar. Tam istek ve yanıt ayrıntıları için /agents/ adresindeki referansı kullan.
Başlamadan önce
- REST API, Professional ve Corporate planlarında bulunur. Basic veya plansız bir hesapta dahil değildir. Planların açıklaması yazısına bak.
- Bir API anahtarına ihtiyacın var. API anahtarları oluştur ve yönet yazısına bak.
Temel akış
- Geliştiriciler bölümünde bir API anahtarı oluştur ve bir kez kopyala.
- PDF’i, anahtarın
API-KEYistek başlığında olacak şekilde API’ye gönder. - Panelde gördüğün aynı güven puanı ve sahtecilik riski derecesiyle geri gelen sonucu oku. Doğrulama sonucunu oku yazısına bak.
Her API doğrulaması, tıpkı bir panel yüklemesi gibi, aylık hakkından veya ön ödemeli bakiyenden bir belge tüketir. Ön ödemeli paketler nasıl çalışır yazısına bak.
Kendi referans kimliğini ekle
Bir doğrulamaya bir custom_id ekleyebilirsin, örneğin iç vaka numaran veya sipariş kimliğin. Bu, doğrulamayı sonradan kendi referansınla aramanı sağlar. Her custom_id hesabın içinde benzersiz olmalıdır.
Hızlı bir örnek
Üst düzeyde, bir istek PDF’i, anahtarını tutan API-KEY başlığıyla birlikte gönderir. Tam uç nokta, istek gövdesi ve yanıt biçimi /agents/ adresindeki API referansında ve panelin Geliştiriciler bölümünün içinde bulunur. Tahmin etmek yerine kopyalamaya hazır örnekler için onları kullan.
Önce test et, sonra canlıya geç
Geliştirirken bir test anahtarı kullan. Gerçek doğrulamalar için bir canlı anahtara geç. Test ve canlı API anahtarları yazısına bak.
Sonraki adımlar
- Sorgulamak yerine sonuçların sana iletilmesini mi istiyorsun? Webhook’ları kur yazısına bak.
- Tam referansa mı ihtiyacın var? /agents/ adresine git.