FTP Dosya Okuma Connector
FTP dosya okuma connector (Bağlayıcı) ile sunucularınız veya farklı ortamlarınızdaki dosyaları belirli kriterlere göre arayabilir, okuyabilir, belirli çıktı formatlarıyla içeriklerini alabilir ve bu işlemleri gerçekleştirip sonuç dönen API Proxy'ler oluşturabilirsiniz.
FTP connector ile;
- FTP sunucularınız ya da farklı ortamlarınızdaki dosya içeriklerine erişebilirsiniz.
- Belirli kriterlere göre dosya arayabilirsiniz.
- Dosya içeriklerini farklı formatlarda indirebilirsiniz.
FTP Dosya Okuma Connector Kullanımı
Oluşturacağınız FTP dosya okuma connector sayesinde, FTP sunucusundan dosya okuma işlemlerini gerçekleştirebilirsiniz. Bu connector, dosya adı başlangıcına, tam eşleşmesine veya belirli bir desene (pattern) göre arama yapma gibi esnek arama kriterleri ve çeşitli çıktı formatlarıyla çıktı üretebilme imkanı sunarak ihtiyacınıza uygun çözümler üretmenizi sağlar.
HTTP İsteği;
curl --location --request POST "https://<APINIZER_ACCESS_URL>/<RELATIVE_PATH>" -H "Content-Type: application/json" --data-raw "{\"caseInsensitive\": true, \"searchType\": \"STARTS_WITH\", \"searchFileName\": \"invoice_2025_\", \"returnType\": \"FIRST_MATCH\", \"maxFileSizeKB\": 10240, \"outputFormat\": \"JSON_BASE64\"}"
Örnek 1; JSON Formatı - İlk Eşleşme
Kullanım Senaryosu : "invoice_2025_" ile başlayan ilk dosyayı bul ve JSON formatında döndür. Maksimum 10 MB boyutundaki dosyaları kabul et.
{
"caseInsensitive": true,
"searchType": "STARTS_WITH",
"searchFileName": "invoice_2025_",
"returnType": "FIRST_MATCH",
"maxFileSizeKB": 10240,
"outputFormat": "JSON_BASE64"
}Örnek 2; ZIP - Tüm Eşleşmeler
Kullanım Senaryosu : İçinde ".pdf" geçen tüm dosyaları bul (büyük/küçük harf duyarlı) ve ZIP arşivi olarak indir.
{
"caseInsensitive": false,
"searchType": "CONTAINS",
"searchFileName": ".pdf",
"returnType": "ALL_MATCHES",
"outputFormat": "ZIP"
}Örnek 3; MTOM (Mesaj İletim Optimizasyon Mekanizması)
Kullanım Senaryosu: "payload.xml" adındaki dosyayı tam eşleşme ile bul ve MTOM formatında döndür.
{
"searchType": "EXACT_MATCH",
"searchFileName": "payload.xml",
"returnType": "FIRST_MATCH",
"outputFormat": "MTOM"
}İstek body'si boş bir şekilde istek atılması durumunda aşağıdaki tabloda bulunan varsayılan değerler geçerli olacaktır.
Request Body Parametreleri
| Parametre | Tip | Varsayılan Değer | Açıklama |
|---|---|---|---|
| caseInsensitive | boolean | true | Dosya adı aramasında büyük/küçük harf duyarlılığı |
| searchType | enum | STARTS_WITH | Aranacak dosya adının nasıl aranacağı |
| searchFileName | string | - | Aranacak dosya adı veya pattern |
| returnType | enum | FIRST_MATCH | Döndürülecek sonuç miktarı |
| maxFileSizeKB | integer | - | İndirilecek maksimum dosya boyutu (KB) |
| outputFormat | enum | JSON_BASE64 | Çıktı formatı |
SearchType ENUM değerleri
SearchType değeri, verilen dosya adı değerinin (searchFileName) ilgili dizinde nasıl aranacağını belirtir.
- STARTS_WITH: Dosya adı değerini belirli bir desen (pattern) ile başladığını kontrol eder.
- EXACT_MATCH: Hedef dosya adının verilen dosya adıyla tam uyuşma durumunu kontrol eder.
- CONTAINS: Dosya adının içinde, verilen deseni (patterni) içerip içermediğini kontrol eder.
ReturnType ENUM değerleri
- FIRST_MATCH: Yalnızca ilk eşleşen dosya döndürülür.
- ALL_MATCH: Tüm eşleşen dosyalar döndürülür.
OutputFormat ENUM değerleri
- JSON_BASE64: JSON formatında, Base64 encode edilmiş dosya içeriği dönülür.
- MTOM: MTOM (Message Transmission Optimization Mechanism) formatında multipart yanıt dönülür.
- ZIP: Eşleşen dosyalar ZIP arşivi içinde dönülür.