Gratis setup bij jaarabonnementen

Meld je vandaag aan!
Plan een demo

Bestand

Home

> API-referentie >

Eindpunten >

Bestand

API-referentie: Bestand-endpoint

De File API biedt de publieke downloadroute voor opgeslagen ticketbericht-bijlagen. Het uploaden, opsommen of verwijderen van bijlagen valt hierbuiten. Deze beheersoperaties behoren tot de TicketMessages-endpoints; de File-route geeft enkel op basis van een toegangstoken toegang tot de bijlage en streamt de opgeslagen bestandsbytes.

Overzicht

Elke ticketbericht-bijlage heeft een accessToken GUID. Wanneer een cliënt /api/File/{accessToken} aanvraagt, zoekt AnswerPal de bijlage op via het token en wordt het bestand teruggegeven met het opgeslagen content type. Het endpoint is bewust anoniem zodat bijlagelinks kunnen worden opgenomen in chat, e-mail, screenshots en gegenereerde berichtinhoud zonder een medewerkers-JWT.

Huidige endpoint

Download met token

  • GET /api/File/{accessToken:guid} – Public
    Download of inline-weergave van één ticketbericht-bijlage via het toegangstoken. De routeparameter moet een GUID zijn. De responsebody bevat binaire bestanddata, geen JSON.

Inline- en downloadresponses

  • Inline-responstypes
    image/png, image/jpeg, image/gif, image/webp, image/svg+xml, application/pdf en text/plain worden zonder download-bestandsnaam teruggegeven zodat ze direct in de browser weergegeven kunnen worden.
  • Download-responstypes
    Alle andere contenttypes worden aangeboden met de opgeslagen bestandsnaam, waardoor ASP.NET Core ze als download verstuurt.
  • Fallback-waarden
    Indien een bijlage geen metadata bevat, gebruikt het endpoint application/octet-stream en download.bin als standaardwaarden.

Beheer van bijlagen gebeurt in TicketMessages

  • GET /api/TicketMessages/{id}/attachments – TicketAccess
    Lijst met bijlagenmetadata voor een ticketbericht. Dit retourneert TicketMessageAttachmentDTO-records met accessToken-waarden, maar zonder fileData.
  • POST /api/TicketMessages/{id}/attachments – TicketAccess
    Upload een nieuwe bijlage als multipart/form-data veld file. De uploadlimiet is 50 MB; de requestbodylimiet is 60 MB.
  • DELETE /api/TicketMessages/{id}/attachments/{attachmentId} – TicketAccess
    Verwijder een bijlage en geconverteerde afgeleiden van een ticketbericht.

Toegangsmodel

  • Publiek op token
    GET /api/File/{accessToken:guid} is gemarkeerd als Public. Bezit van het GUID-token verleent toegang tot het bestand.
  • Geen lijstweergave op token
    Het Bestand-endpoint kan geen bijlagen opsommen of metadata van willekeurige tokens teruggeven. Gebruik de TicketMessages-endpoints onder geauthenticeerd tickettoegang voor beheeroperaties.
  • Levenscyclus van token
    Het Bestand-endpoint leest de huidige bijlagerij. Indien de bijlage verwijderd is, werkt het token niet meer.
  • Bearer JWT elders
    Beschermde AnswerPal API-endpoints gebruiken JWT Bearer-authenticatie. Uploaden, lijstweergave en verwijderen van bijlagen vereist tickettoegang via de TicketMessages-endpoints.

Velden en DTO's

Bijlagevelden

Velden gebruikt door het Bestand-endpoint

  • accessToken
    GUID gebruikt als routeparameter voor GET /api/File/{accessToken:guid}.
  • fileData
    Opgeslagen bytes die in de responsebody worden gestreamd. Dit veld wordt nooit teruggegeven in TicketMessageAttachmentDTO metadata.
  • contentType
    Opgeslagen MIME-type gebruikt als response Content-Type. Valt terug op application/octet-stream bij ontbreken.
  • fileName
    Opgeslagen bestandsnaam voor niet-inline downloads. Valt terug op download.bin bij ontbreken.

Bijlagemetadata velden geretourneerd door TicketMessages

  • ticketMessageAttachmentID, messageID
    Bijlage-identiteit en het bijbehorende ticketbericht.
  • fileName, contentType, fileSizeBytes, createdDateTime
    Metadata die clients gebruiken alvorens downloadlinks samen te stellen.
  • isEndUserProvided, isCustomerRepProvided, convertedFromAttachmentID, contentId
    Bron-, conversie- en inline-message metadata.
  • accessToken
    Token dat clients toevoegen aan https://api.answerpal.eu/api/File/ om het binaire bestand op te halen.

Statuscodes

  • 200 OK
    Het token komt overeen met een bijlage en het endpoint retourneert de binaire bestandsinhoud.
  • 404 Not Found
    Er bestaat geen bijlage voor het opgegeven token, of de URL voldoet niet aan het GUID-routecriterium.
  • Geen 401/403 voor dit endpoint
    De File-route zelf is anoniem. Autorisatie is vereist voor het verkrijgen van bijlagemetadata of het uploaden/verwijderen van bestanden via TicketMessages.

Voorbeelden en scenario's

Download-URL vanaf een toegangstoken

GET https://api.answerpal.eu/api/File/11111111-2222-3333-4444-555555555555

Gebruik bijlagemetadata om een link op te bouwen

GET /api/TicketMessages/987/attachments
Authorization: Bearer <token>

[
  {
    "ticketMessageAttachmentID": 41,
    "messageID": 987,
    "fileName": "invoice.pdf",
    "contentType": "application/pdf",
    "fileSizeBytes": 58214,
    "accessToken": "11111111-2222-3333-4444-555555555555"
  }
]

Download of bekijk:
https://api.answerpal.eu/api/File/11111111-2222-3333-4444-555555555555
  • Inline-preview
    Een PDF, afbeelding of tekstbijlage opent direct in de browser omdat het MIME-type op de inline allow-list staat.
  • Bijlagendownload
    Een spreadsheet, archief of onbekend binair bestand wordt met de opgeslagen bestandsnaam als download aangeboden.
  • Ingebedde gegenereerde inhoud
    Gegenereerde screenshots en berichtinhoud kunnen verwijzen naar https://api.answerpal.eu/api/File/{accessToken} zonder dat hiervoor een ingelogde medewerkerssessie vereist is.

Inhoudstafel

AnswerPal: AI-gedreven oplossingen voor klantenservice die je ondersteuning en communicatie moeiteloos versterken.

Snelle links

Contact

Voor ondersteunings-, commerciële en partnervragen kunt u mailen naar [email protected]

AnswerPal
Bisschoppenhoflaan 380
2100 Antwerpen
België

+32.36416685

BE 0862.692.858

Sociale media