Zum Hauptinhalt springen
Sourcemaps werden verwendet, um die ursprüngliche Zeilen- und Spaltennummer aus einem Backtrace zu ermitteln, der auf eine minifizierte oder transpilierte Datei verweist. Wir empfehlen, nach Möglichkeit öffentliche Sourcemaps zu verwenden. Builds, die viele Sourcemaps erzeugen, können beim Hochladen über unseren privaten Sourcemap-Endpunkt lange dauern. Diese API bietet eine einfache Möglichkeit, private Sourcemaps für die Verwendung mit Frontend-Fehlern hochzuladen.
Private Sourcemaps werden nicht verwendet, um Node.js-Backtraces aufzulösen.Folgen Sie der Node.js-Installationsanleitung, um Ihre Anwendung so zu konfigurieren, dass sourcemappierte Backtraces ausgegeben werden.

​
Sourcemap erstellen

Dieser Endpunkt ermöglicht das Erstellen privater Sourcemaps.
Endpunkt/api/sourcemaps
Request-MethodePOST
Content-Typemultipart/form-data
Erfordert Authentifizierung?Ja (Push-API-Schlüssel)
Response-FormateJSON

​
Sourcemaps zuordnen

Wir gleichen die Werte für die name[]-Felder mit der vollständigen Backtrace-URL ab. Zum Beispiel die folgende Backtrace-Zeile:
Shell
  at https://test.local/main.abc123.js:1:92623
Wird mit dem name https://test.local/main.abc123.js abgeglichen. Sie können mehrere name-Einträge in einer curl-Anfrage hinzufügen: 
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'
Beachten Sie, dass Sie nur eine Sourcemap-Datei auf einmal hochladen können. Wenn Sie also mehrere Sourcemap-Dateien haben, müssen Sie für jede Datei eine separate Upload-Anfrage senden. Die maximal zulässige Upload-Größe für eine Sourcemap-Datei beträgt 100 MB.

​
Parameter

Alle Parameter außer file können entweder im POST-Body oder als GET-Parameter gesendet werden. Alle Parameter sind erforderlich.
ParameterTypBeschreibung
push_api_keyStringDer Push-API-Schlüssel Ihrer Organisation.
app_nameStringName der Anwendung in AppSignal, in der die Sourcemap verwendet werden soll.
environmentStringUmgebung der Anwendung in AppSignal, in der die Sourcemap verwendet werden soll.
revisionStringRevisionsreferenz des Deploy Markers.
nameArray von StringsListe der Dateinamen, die die Sourcemap abdeckt. Dies sollte eine vollständige URL zur minifizierten JavaScript-Datei sein, wie sie im Backtrace erscheint, einschließlich aller URL-Parameter.
fileDateiSourcemap zum Hochladen.

​
Responses

  • Die API gibt bei Erfolg den HTTP-Statuscode 201 zurück.
  • Die API gibt bei einem Validierungsfehler den HTTP-Statuscode 400 mit einer JSON-Response zurück.
  • Die API gibt den HTTP-Statuscode 404 zurück, wenn für die gegebene Kombination aus App-Name, Umgebung und Push-API-Schlüssel keine App existiert.
Beispiel für einen 400-Response-Body: 
{ "errors": ["The following errors were found: Name can't be empty"] }

​
Beispiel

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'