{"id":14493,"date":"2025-03-07T16:45:15","date_gmt":"2025-03-07T13:45:15","guid":{"rendered":"https:\/\/fatihsoysal.com\/blog\/fastapi-ile-doclingin-rest-uygulamasi\/"},"modified":"2025-03-07T16:45:15","modified_gmt":"2025-03-07T13:45:15","slug":"fastapi-ile-doclingin-rest-uygulamasi","status":"publish","type":"post","link":"https:\/\/fatihsoysal.com\/blog\/fastapi-ile-doclingin-rest-uygulamasi\/","title":{"rendered":"FastAPI ile Docling’in REST Uygulamas\u0131"},"content":{"rendered":"

<\/p>\n

FastAPI ile Docling’in REST Uygulamas\u0131<\/p>\n

Merhaba! Bu makalede, pop\u00fcler Python web framework’\u00fc FastAPI ile Docling’in RESTful bir implementasyonunu nas\u0131l olu\u015fturabilece\u011finizi ad\u0131m ad\u0131m a\u00e7\u0131klayaca\u011f\u0131m. Docling, dok\u00fcmanlar\u0131n i\u015flenmesi ve y\u00f6netimi i\u00e7in kullan\u0131labilecek g\u00fc\u00e7l\u00fc bir ara\u00e7t\u0131r. Bu nedenle, REST API ile entegre edilmesi, \u00f6zellikle b\u00fcy\u00fck veri k\u00fcmeleriyle \u00e7al\u0131\u015fan uygulamalar i\u00e7in olduk\u00e7a faydal\u0131d\u0131r. \u00d6ncelikle, Docling’in ne oldu\u011funu ve neden REST API ile b\u00fct\u00fcnle\u015ftirilmesinin \u00f6nemli oldu\u011funu ele alal\u0131m. Daha sonra, FastAPI kullanarak ad\u0131m ad\u0131m bir uygulama olu\u015fturaca\u011f\u0131z. Son olarak da, olu\u015fturdu\u011fumuz API’yi test ederek sonu\u00e7lar\u0131 de\u011ferlendirece\u011fiz.<\/p>\n

Docling ve REST API Entegrasyonu<\/h2>\n

Docling, genellikle b\u00fcy\u00fck \u00f6l\u00e7ekli dok\u00fcman i\u015fleme gerektiren projelerde kullan\u0131lan, olduk\u00e7a g\u00fc\u00e7l\u00fc bir ara\u00e7t\u0131r. Ancak, bu arac\u0131 daha eri\u015filebilir ve \u00f6l\u00e7eklenebilir hale getirmek i\u00e7in, bir REST API ile b\u00fct\u00fcnle\u015ftirmek olduk\u00e7a \u00f6nemlidir. Bu entegrasyon sayesinde, di\u011fer uygulamalar ve servisler kolayca Docling’in yeteneklerinden faydalanabilir. \u00d6rne\u011fin, bir web uygulamas\u0131, kullan\u0131c\u0131 taraf\u0131ndan y\u00fcklenen dok\u00fcmanlar\u0131 Docling arac\u0131l\u0131\u011f\u0131yla i\u015fleyebilir ve sonu\u00e7lar\u0131 kullan\u0131c\u0131ya sunabilir. Bu i\u015flem, API sayesinde olduk\u00e7a basit ve verimli bir \u015fekilde ger\u00e7ekle\u015ftirilebilir. Bu da, uygulaman\u0131n genel performans\u0131n\u0131 ve \u00f6l\u00e7eklenebilirli\u011fini art\u0131r\u0131r.<\/p>\n

FastAPI ile Uygulama Geli\u015ftirme<\/h2>\n

FastAPI, Python ile y\u00fcksek performansl\u0131 REST API’ler geli\u015ftirmek i\u00e7in ideal bir framework’t\u00fcr. H\u0131zl\u0131 ve verimli olmas\u0131yla bilinir. Ayr\u0131ca, yaz\u0131m\u0131 kolay ve anla\u015f\u0131l\u0131r bir s\u00f6zdizimine sahiptir. \u015eimdi, FastAPI kullanarak basit bir Docling REST API’si olu\u015ftural\u0131m. A\u015fa\u011f\u0131daki kod blo\u011fu, bir dok\u00fcman\u0131 i\u015fleyen ve sonucu d\u00f6nd\u00fcren basit bir endpoint tan\u0131mlar:<\/p>\n

\nfrom fastapi import FastAPI, UploadFile, File\nfrom docling import process_document # Docling k\u00fct\u00fcphanesini varsayal\u0131m\n\napp = FastAPI()\n\n@app.post(\"\/process\")\nasync def process_document_endpoint(file: UploadFile = File(...)):\n    contents = await file.read()\n    result = process_document(contents) # Docling fonksiyonunu \u00e7al\u0131\u015ft\u0131r\u0131yoruz.\n    return {\"result\": result}\n<\/code><\/pre>\n
Bu kod,  \/process endpoint’ine bir dosya g\u00f6nderildi\u011finde,  dosyay\u0131 okuyup Docling ile i\u015fleyerek sonucu d\u00f6nd\u00fcren bir fonksiyon tan\u0131mlar.  Bu basit \u00f6rnek,  daha karma\u015f\u0131k i\u015flevsellikler eklenerek geni\u015fletilebilir. \u00d6rne\u011fin,  farkl\u0131 dok\u00fcman t\u00fcrlerini i\u015fleme,  \u00f6zel parametreler kullanma veya sonu\u00e7lar\u0131 farkl\u0131 formatlarda d\u00f6nd\u00fcrme gibi \u00f6zellikler ekleyebilirsiniz.  Ayr\u0131ca,  hata y\u00f6netimi ve g\u00fcvenlik \u00f6nlemleri de eklenmelidir.<\/p>\n
Uygulaman\u0131n Test Edilmesi ve Sonu\u00e7lar<\/h2>\n
Olu\u015fturdu\u011fumuz API’yi test etmek i\u00e7in,  bir HTTP istek k\u00fct\u00fcphanesi (\u00f6rne\u011fin, requests) kullanabiliriz.  Bir dosyay\u0131 \/process endpoint’ine g\u00f6nderip,  sonucu kontrol edebiliriz.  Ba\u015far\u0131l\u0131 bir \u015fekilde \u00e7al\u0131\u015f\u0131yorsa,  API’mizin Docling ile do\u011fru bir \u015fekilde entegre oldu\u011funu ve beklendi\u011fi gibi \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 s\u00f6yleyebiliriz.  Elbette,  ger\u00e7ek d\u00fcnya uygulamalar\u0131 i\u00e7in daha kapsaml\u0131 testler yapmak gerekecektir.<\/p>\n
Bu makalede, FastAPI ile Docling entegrasyonunu temel d\u00fczeyde ele ald\u0131k.  Daha geli\u015fmi\u015f uygulamalar i\u00e7in,  hata y\u00f6netimi,  g\u00fcvenlik \u00f6nlemleri,  veritaban\u0131 entegrasyonu ve daha karma\u015f\u0131k i\u015flevsellikler eklemek gerekebilir.  Daha detayl\u0131 bilgi i\u00e7in, FastAPI ve Docling belgelerini inceleyebilirsiniz. Ayr\u0131ca, kendi web sitemi fatihsoysal.com<\/a> adresinden daha fazla bilgiye ula\u015fabilirsiniz.<\/p>\n
Umar\u0131m bu makale faydal\u0131 olmu\u015ftur.  Herhangi bir sorunuz varsa,  l\u00fctfen yorumlarda belirtmekten \u00e7ekinmeyin!<\/p>\n
Faydal\u0131 Kaynaklar:<\/strong><\/p>\n