Hoe Je Logo Wordt Opgeslagen Wanneer Je Het Uploadt

Je bedrijfslogo verschijnt op elke factuur die je genereert, wat betekent dat het er maanden of jaren later nog steeds moet zijn, zelfs als de plek waar je de afbeelding oorspronkelijk vandaan haalde offline gaat, de URL-structuur verandert, of gelinkte verzoeken begint te blokkeren. Die betrouwbaarheidseis verklaart waarom logo-opslag werkt zoals het werkt: als je je bedrijfsprofiel instelt op een externe afbeeldings-URL, slaat de server niet zomaar die URL op — hij haalt de afbeelding zelf op en zet deze om in iets zelfstandigs.

Twee Verschillende Startpunten, Eén Opgeslagen Resultaat

Er zijn eigenlijk twee manieren waarop een logo-waarde bij de server kan aankomen. Als je een bestand rechtstreeks uploadt via de logokiezer, codeert de browser dit doorgaans al als een data-URL — de afbeeldingsbytes zelf, base64-gecodeerd en direct ingebed in een string — voordat het ooit wordt verstuurd. Als je in plaats daarvan een link plakt naar een afbeelding die ergens anders wordt gehost, is dat een gewone http://- of https://-URL, wat een verwijzing naar een afbeelding is in plaats van de afbeelding zelf. De server behandelt deze twee gevallen verschillend: alles wat al een data-URL is, wordt met rust gelaten, terwijl alles wat wordt herkend als een externe HTTP- of HTTPS-URL wordt opgehaald en omgezet voordat het wordt opgeslagen.

Wat Er Gebeurt Als Je Naar Een Externe URL Wijst

Wanneer de op te slaan waarde een externe URL is, doet de server zijn eigen HTTP-verzoek om deze op te halen — met een Accept-header die veelvoorkomende afbeeldingsformaten opsomt en een aparte user-agent die het verzoek identificeert als afkomstig van de eigen ophaler van het factureringsplatform, niet van een browser. Als dat verzoek volledig mislukt, of het contenttype van de respons niet begint met image/, wordt het opslaan geweigerd met een melding die je vertelt dat de logo-URL niet kon worden geladen en voorstelt om het bestand rechtstreeks te uploaden of een URL te gebruiken die daadwerkelijk bereikbaar is. Deze controle bestaat specifiek om te voorkomen dat iemand het logoveld richt op, bijvoorbeeld, een HTML-pagina of een omleidingsketen die nooit tot echte afbeeldingsbytes leidt.

De Limiet van 2MB, Twee Keer Gecontroleerd

Opgehaalde afbeeldingen zijn beperkt tot 2MB, en die limiet wordt op twee plekken afgedwongen in plaats van één. Ten eerste, als de content-length-header van de respons een grootte boven de limiet rapporteert, wordt het verzoek meteen geweigerd zonder de inhoud überhaupt te downloaden. Maar omdat een server niet verplicht is een eerlijke content-length-header te sturen, wordt het werkelijk gedownloade aantal bytes opnieuw gecontroleerd nadat de volledige afbeelding in het geheugen is ingelezen, en ook op dat punt geweigerd als blijkt dat het de limiet overschrijdt ondanks wat de header beweerde. Beide controles geven dezelfde fout "afbeelding is te groot"; het verschil zit puur in het niet verspillen van tijd en bandbreedte aan het downloaden van een te groot bestand wanneer de header alleen al dat verraadt.

Waarom Omzetten naar een Data-URL in Plaats van Gewoon de Link Opslaan

Zodra een ophaalactie slaagt en beide groottecontroles doorstaat, worden de afbeeldingsbytes base64-gecodeerd en gecombineerd met het contenttype van de respons tot een data-URL, en die data-URL — niet de oorspronkelijke externe link — is wat als je logo wordt opgeslagen. Dit is het deel dat het betrouwbaarheidsprobleem daadwerkelijk oplost: zodra de omzetting heeft plaatsgevonden, is je opgeslagen logo niet langer afhankelijk van het feit dat de oorspronkelijke URL online, ongewijzigd en bereikbaar blijft. Als de site waar je oorspronkelijk naar linkte later offline gaat, zijn afbeeldingspaden wijzigt, of verzoeken van buiten browsers begint te blokkeren, worden je facturen daar niet door beïnvloed, omdat het platform die URL niet meer ophaalt — het heeft deze precies één keer opgehaald, op het moment van opslaan, en heeft sindsdien zijn eigen zelfstandige kopie bewaard.

De Afweging Die Je Accepteert

De prijs van deze aanpak is dat je logo bevroren is op hoe het eruitzag op het moment dat je het opsloeg. Als je de afbeelding op de oorspronkelijke URL later bijwerkt — een herontwerp, een versie met hogere resolutie — zal die wijziging niet automatisch doorwerken naar je factuurlogo, omdat het platform na de eerste omzetting helemaal niet meer naar die URL kijkt. Je logo voortaan bijwerken betekent je bedrijfsprofiel opnieuw opslaan met de nieuwe afbeelding, op dezelfde manier als toen je het voor het eerst instelde, in plaats van het bestand op het oorspronkelijke adres te bewerken en te verwachten dat het doorstroomt.