fileUpload
Genel Bilgi
| Özellik |
Değer |
| Endpoint Adı |
fileUpload |
| SOAPAction |
urn:WebticariService#fileUpload |
| Açıklama |
Genel amaçlı dosya yükleme endpoint'i. Herhangi bir dosyayı Base64 kodlanmış veri olarak sisteme yükler. Belge, resim, PDF gibi içeriklerin SOAP üzerinden aktarılması için kullanılır. |
| Kimlik Doğrulama Gerektirir |
Evet (token) |
İstek Parametreleri
| Parametre |
Tip |
Zorunlu |
Açıklama |
token |
xsd:string |
Evet |
login endpoint'inden alınan oturum token'ı |
dataType |
xsd:string |
Evet |
Dosya işleme türü: ticketAmaduse, ticketGalileo, ticketSabre, ticketSabreXml |
fileName |
xsd:string |
Evet |
Yüklenecek dosyanın adı (uzantı dahil, örn. belge.pdf) |
file |
xsd:base64Binary |
Evet |
Dosya içeriği Base64 kodlanmış formatta |
Yanıt Parametreleri
| Parametre |
Tip |
Açıklama |
return |
xsd:string |
Sunucudaki dosya yolu veya benzersiz dosya adı; başarısızlık durumunda hata mesajı |
PHP Kullanım Örneği
$fileContent = base64_encode(file_get_contents('/path/to/file.txt'));
$result = $client->fileUpload([
'token' => $token,
'dataType' => 'ticketSabre',
'fileName' => 'bilet.txt',
'file' => $fileContent,
]);
Örnek SOAP İstek
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tns="urn:WebticariService">
<soapenv:Header/>
<soapenv:Body>
<tns:fileUpload>
<token>abc123tokendeğeri</token>
<dataType>ticketSabre</dataType>
<fileName>bilet.txt</fileName>
<file>JVBERi0xLjMKJcTl8uXrp...</file>
</tns:fileUpload>
</soapenv:Body>
</soapenv:Envelope>
Notlar
- Token gereklidir.
- Dosya
temp/{db}{personel2}_{fileName} yoluna kaydedilir.
dataType değeri şu an yalnızca bilet sistemi türlerini destekler: ticketAmaduse, ticketGalileo, ticketSabre, ticketSabreXml.
class_ticket.php sınıfı dosyayı işler; >0 satır işlenirse 'true', hata varsa hata çıktısı döner.
- E-Defter'e özgü dosya yüklemek için
eBookFileUpload endpoint'ini kullanın.
- Büyük dosyalar için SOAP message size limitine dikkat edilmelidir.