Nem használt feltöltési hivatkozás eltávolítása

Válasszon egy nem használt feltöltési hivatkozást

Ez a végpont a fiókjához tartozó feltöltésihivatkozás-rekordot távolít el. Csak akkor használja, ha biztos abban, hogy a hivatkozásra már nincs szükség a következő műveletekhez: igazolás csatolása vagy alátámasztó dokumentum csatolása. Nem töröl regisztrációs személyazonossági rekordot vagy címet.

A külső fájlazonosítót az alábbi források valamelyikéből szerezheti be: az eredeti feltöltési válasz vagy az elérhető feltöltések listája. A kezelő először ezt az azonosítót keresi meg a fiókjához kapcsolódóan; ha így nem találja, a korábbi szolgáltatói azonosító alapján is keres. Az új integrációk a külső hivatkozást pontosan a visszaadott formában használják. A kéréshez nem szükséges törzs.

Az eltávolítást tudatos műveletként kérje

Használjon engedélyezett MultiTEL API-fiókot HTTPS-kapcsolaton keresztül, a fiókhoz beállított hitelesítő adatokkal és IP-korlátozásokkal. Használja a POST metódust, hogy az alkalmazása tudatos módosításként kezelje a műveletet:

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

A jelenlegi kezelő nem érvényesít HTTP-metódusra vonatkozó korlátozást: egy GET kérés is eljuthat a törlésig. Ne tegye elérhetővé ezt az URL-t szokásos kattintható hivatkozásként, képként, könyvjelzőként, előnézet vagy előzetes letöltés célpontjaként. Az alkalmazásban követeljen meg kifejezett eltávolítási műveletet, és ne próbálkozzon újra automatikusan.

Értelmezze az eredményt és annak korlátait

Olvassa ki mind a HTTP eredményét, mind a JSON status.code mezőjét. A szokásos sikeres válasz:

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

Az API 404 kódja a Failed, Not found üzenettel azt jelenti, hogy egyik keresés sem talált megfelelő hivatkozást ehhez a fiókhoz. Az ismételt eltávolítás ezért 404 kódot adhat vissza. Az útvonalérték elején és végén lévő szóközök eltávolításra kerülnek. Itt nincs ellenőrzés arra, hogy a hivatkozás nem járt-e le, vagy nem használja-e egy másik lépés, ezért eltávolítás előtt ellenőrizze a munkafolyamatát.

A kezelő az adatbázisbeli törlés megkísérlése után sikert jelez, anélkül hogy ellenőrizné, sikerült-e a törlés. A választ a művelet jelentett eredményeként kezelje, ne a törlés független bizonyítékaként. Ha egy még le nem járt, API által létrehozott hivatkozás látható volt a get_encrypted_files listájában, ez a lista segíthet ellenőrizni, hogy továbbra is látható-e, de a listából való hiány lejáratot is jelenthet.

Az eltávolítás nem jelent teljes adattörlést

A kezelő törlési műveletet ad ki a feltöltési hivatkozások táblájára. Nem törli kifejezetten a tárolt dokumentumtartalom sorát, a helyi feltöltött fájlt, a csatolt igazolást, a személyazonossági rekordot, az alátámasztó dokumentumot vagy a szolgáltatónál tárolt másolatot. Az adatbázis kaszkádolt műveleteinek és adatmegőrzésének működését nem ellenőrizték. Ne állítsa a felhasználóknak, hogy ez a művelet törli a személyazonosító okmányuk összes másolatát, vagy teljesít egy átfogó törlési kérelmet.

A helyi hivatkozás eltávolítása után az azt igénylő későbbi csatolási lépések meghiúsulhatnak. Őrizze meg a már befejezett csatolások eredményeit, és a beküldött regisztrációs adatok módosításakor használja a megfelelő személyazonosság- vagy igazoláskezelési munkafolyamatot.