Уклоните некоришћену референцу на отпремљену датотеку

Изаберите некоришћену референцу на отпремљену датотеку

Ова крајња тачка уклања запис референце на отпремљену датотеку који припада вашем налогу. Користите је само када сте сигурни да референца више није потребна за прилагање доказа или прилагање пратећег документа. Тиме се не бришу идентитет или адреса за регистрацију.

Преузмите спољни идентификатор датотеке из изворног одговора на отпремање или списка доступних отпремљених датотека. Обрађивач најпре тражи тај идентификатор за ваш налог, а ако га не пронађе, користи старији начин претраге по идентификатору добављача. Нове интеграције треба да користе спољну референцу тачно онако како је враћена. Тело захтева није потребно.

Затражите уклањање као свесну радњу

Користите активиран MultiTEL API налог преко HTTPS, са подешеним приступним подацима и ограничењима IP адреса. Користите POST како би ваша апликација ово третирала као намерну измену:

curl --silent --show-error --request POST \
  --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdef

Тренутни обрађивач не спроводи ограничење HTTP метода: и захтев GET може довести до брисања. Немојте излагати овај URL као обичну везу на коју се може кликнути, слику, обележивач, нити као одредиште за преглед или унапред учитавање. У својој апликацији захтевајте изричиту радњу уклањања и немојте аутоматски понављати захтев.

Протумачите резултат и његова ограничења

Прочитајте и HTTP резултат и поље status.code у JSON одговору. Уобичајени успешан одговор је:

{
  "status": {"code": 200, "msg": "Success"},
  "response": []
}

Код API одговора 404 уз Failed, Not found значи да ниједна од две претраге није пронашла одговарајућу референцу за овај налог. Поновљено уклањање зато може вратити 404. Размаци на почетку и крају вредности у путањи се уклањају. Овде се не проверава да ли референца још важи нити да ли је неки други корак користи, па пре уклањања проверите свој поступак.

Обрађивач пријављује успех након покушаја брисања из базе података, без провере да ли је брисање успело. Сматрајте одговор пријављеним резултатом, а не независним доказом брисања. Ако је референца која још важи и која је направљена преко API била видљива у get_encrypted_files, тај списак може помоћи да проверите да ли је и даље видљива, али одсуство са списка може значити и да јој је истекло важење.

Уклањање није потпуно брисање података

Обрађивач издаје наредбу за брисање из табеле референци на отпремљене датотеке. Он не брише изричито сачувани ред са садржајем документа, локалну отпремљену датотеку, приложени доказ, идентитет, пратећи документ нити копију коју чува добављач. Понашање каскадног брисања у бази података и задржавања података није проверено. Немојте корисницима представљати ову операцију као брисање свих копија њиховог идентификационог документа или као испуњавање захтева за свеобухватно брисање.

Када се локална референца уклони, каснији кораци прилагања којима је она потребна могу бити неуспешни. Сачувајте резултате већ завршених прилагања и користите одговарајући поступак за управљање идентитетом или доказима када мењате послате податке за регистрацију.