Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Описание

Получения списка ссылок на скачивание файлов, переданных по линиям поддержки. При вызове операции в дневное время максимальное значение запрашиваемого периода не может превышать 90 календарных дней (7 дней без подписки на расширенный функционал).


Page Properties


НаименованиеGetHistoryOfServiceFileTransfer
НазначениеИстория обмена файлами в чате по линиям
Дневной лимит (опер/час)250
Ночной лимит (опер/час)1250
Максимум объектов в пакете-



Запрос

Info

Параметр, выделенный жирным, является обязательным к заполнению!


ПараметрТипNULLОписание
PeriodFromДатаВремяЧПЛК


Позволяет отбирать файлы, переданные после указанного времени. В дневное время обязательный параметр, ночью ограничения снимаются.
PeriodToДатаВремяЧПЛК
Позволяет отбирать файлы, переданные после указанного времени.
OwnerUserID4.1.2.5. AccountID
Уникальный идентификатор агента, получающего поддержку по линии.
ServiceID4.1.2.9. ServiceID
Линия (поддержки), по которой производился обмен файлами


Code Block
languagexml
titleПример
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:par="http://buhphone.com/PartnerWebAPI2" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:core="http://v8.1c.ru/8.1/data/core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soap:Header/>
   <soap:Body>
      <par:GetHistoryOfServiceFileTransfer>
         <par:Params>
            <Property name="PeriodFrom" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:dateTime">2019-09-21T01:00:00</Value>
            </Property>
            <Property name="PeriodTo" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:dateTime">2019-09-29T01:00:00</Value>
            </Property>
            <Property name="OwnerUserID" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">0e0a9b78-2003-4f6c-bd33-ca248f7f9baf</Value>
            </Property>
            <Property name="ServiceID" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">fbe839ae-07ec-2003-80e6-0025904f970f</Value>
            </Property>                                    
         </par:Params>
      </par:GetHistoryOfServiceFileTransfer>
   </soap:Body>
</soap:Envelope>


Ответ (структура ResultData)

ПараметрТипОписание
FileIDUUIDСтрокаУникальный идентификатор файла
StatusСтрока

Текущее состояние файла. Значения:

  • DOWNLOADED – доступен для скачивания,
  • EXPIRED – истек срок хранения файла,
  • DELETED – файл удален
OwnerUserID4.1.2.5. AccountIDПолучатель поддержки
ServiceID4.1.2.9. ServiceIDЛиния
SourceAgentID4.1.2.5. AccountIDКто опубликовал (выложил) файл в чате
UploadedAtДатаВремяЧПЛКВремя публикации на сервере
FileNameСтрока(255)Имя файла
FileExtensionСтрока(7)Расширение файла
FileSizeЧисло(12)Размер файла в байтах
DownloadLinkFileLinkСсылка на скачивание.
FileCheckSumMD5Строка(60) <MD5 Hash>Контрольная сумма MD5


Code Block
languagexml
titleПример ответа
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
   <soap:Body>
      <m:GetHistoryOfServiceFileTransferResponse xmlns:m="http://buhphone.com/PartnerWebAPI2">
         <m:return xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <Property name="ResultCode" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">SUCCESS</Value>
            </Property>
            <Property name="ResultData" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="ValueTable">
                  <column>
                     <Name>FileID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>50<<Length>80</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>Status</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>10</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>OwnerUserID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ServiceID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>SourceAgentID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>UploadedAt</Name>
                     <ValueType>
                        <Type>xs:dateTime</Type>
                        <DateQualifiers>
                           <DateFractions>DateTime</DateFractions>
                        </DateQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>FileName</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>255</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>FileExtension</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>7</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>FileSize</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>12</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Any</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>DownloadLink</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>119</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>FileCheckSumMD5</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>60</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <row>
                     <Value xsi:type="xs:string">5/5cafc185241b4165ef212a1ac4046b77-1569585583</Value>
                     <Value xsi:type="xs:string">DOWNLOADED</Value>
                     <Value xsi:type="xs:string">0e0a9b78-2003-4f6c-bd33-ca248f7f9baf</Value>
                     <Value xsi:type="xs:string">fbe839ae-07ec-2003-80e6-0025904f970f</Value>
                     <Value xsi:type="xs:string">79d4067b-6f12-451a-2003-1ba1d6a61c1e</Value>
                     <Value xsi:type="xs:dateTime">2019-09-27T16:54:53</Value>
                     <Value xsi:type="xs:string">fileoftransfer.xml</Value>
                     <Value xsi:type="xs:string">xml</Value>
                     <Value xsi:type="xs:decimal">409</Value>
                     <Value xsi:type="xs:string">https://filetransfer.buhphone.com/partner/api/download/service/5/5cafc185241b4165ef212a1ac4046b77-1569585583</Value>
                     <Value xsi:type="xs:string">5cafc185241b416200312a1ac4046b77</Value>
                  </row>
                </Value>
            </Property>
         </m:return>
      </m:GetHistoryOfServiceFileTransferResponse>
   </soap:Body>
</soap:Envelope>