Ana içeriğe geç

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.