Naar hoofdinhoud gaan
Sourcemaps worden gebruikt om het oorspronkelijke regel- en kolomnummer op te halen uit een backtrace die naar een geminimaliseerd of getranspileerd bestand verwijst. Wij raden aan om waar mogelijk publieke sourcemaps te gebruiken. Builds die veel sourcemaps produceren, kunnen lang duren om te uploaden via ons private sourcemap-endpoint. Deze API biedt een eenvoudige manier om private sourcemaps te uploaden voor gebruik met frontend errors.
Private sourcemaps worden niet gebruikt om Node.js-backtraces op te lossen.Volg de Node.js-installatie-instructies om uw applicatie zo te configureren dat sourcemap-backtraces worden gegenereerd.

​
Sourcemap aanmaken

Met dit endpoint kunt u private sourcemaps aanmaken.
Endpoint/api/sourcemaps
Request-methodePOST
Content-Typemultipart/form-data
Vereist authenticatie?Ja (Push API key)
ResponseformatenJSON

​
Sourcemaps matchen

Wij matchen de waarden voor de name[]-velden tegen de volledige backtrace-URL. Bijvoorbeeld, de volgende backtrace-regel:
Shell
  at https://test.local/main.abc123.js:1:92623
Zal matchen met de name: https://test.local/main.abc123.js. U kunt meerdere name’s toevoegen in één curl-request: 
curl -k -X POST -H 'Content-Type: multipart/form-data' \
  -F 'name[]=https://test.local/main.abc123.js' \
  -F 'name[]=https://cdn.local/main.abc123.js' \
  -F 'revision=abcdef' \
  -F 'file=@/~project/main.js.map' \
  'https://appsignal.com/api/sourcemaps?push_api_key=xxx&app_name=AppSignal&environment=development'
Let op: u kunt slechts één sourcemap-bestand tegelijk uploaden. Als u meerdere sourcemap-bestanden heeft, moet u voor elk bestand een aparte uploadrequest sturen. De maximale uploadgrootte voor een sourcemap-bestand is 100 MB.

​
Parameters

Alle parameters, behalve file, kunnen ofwel in de POST-body ofwel als GET-parameters worden verzonden. Alle parameters zijn verplicht.
ParameterTypeBeschrijving
push_api_keyStringDe Push API key van uw organisatie.
app_nameStringNaam van de applicatie in AppSignal waarin de sourcemap moet worden gebruikt.
environmentStringOmgeving van de applicatie in AppSignal waarin de sourcemap moet worden gebruikt.
revisionStringDeploy marker revisiereferentie.
nameArray of StringsLijst van bestandsnamen die de sourcemap dekt. Dit moet een volledige URL zijn naar het geminimaliseerde JavaScript-bestand, zoals u dat ziet in de backtrace, inclusief eventuele URL-parameters.
fileFileTe uploaden sourcemap.

​
Responses

  • De API geeft een HTTP-statuscode 201 terug als het succesvol is.
  • De API geeft een HTTP-statuscode 400 terug met een JSON-response wanneer er een validatie-error is opgetreden.
  • De API geeft een HTTP-statuscode 404 terug als er geen app bestaat voor de gegeven combinatie van app-naam, omgeving en Push API key.
Voorbeeld van een 400-responsebody: 
{ "errors": ["The following errors were found: Name can't be empty"] }

​
Voorbeeld

curl -k -X POST -H 'Content-Type: multipart/form-data' \
  -F 'name[]=https://localhost:3000/application.min.js?vsn=d ' \
  -F 'revision=abcdef' \
  -F 'file=@/~project/application.js.map' \
  'https://appsignal.com/api/sourcemaps?push_api_key=xxx&app_name=MyApp&environment=development'