Passer au contenu principal
Les sourcemaps sont utilisées pour obtenir le numéro de ligne et de colonne d’origine à partir d’une backtrace pointant vers un fichier minifié ou transpilé. Nous recommandons d’utiliser des sourcemaps publiques chaque fois que possible. Les builds qui produisent beaucoup de sourcemaps peuvent prendre beaucoup de temps à être téléchargés via notre point de terminaison de sourcemap privé. Cette API offre un moyen simple de télécharger des sourcemaps privées pour les utiliser avec les erreurs frontend.
Les sourcemaps privées ne seront pas utilisées pour résoudre les backtraces Node.js.Suivez les instructions d’installation Node.js pour configurer votre application afin qu’elle émette des backtraces avec sourcemap.

​
Créer une sourcemap

Ce point de terminaison permet la création de sourcemaps privées.
Point de terminaison/api/sourcemaps
Méthode de requêtePOST
Content-Typemultipart/form-data
Authentification requise ?Oui (Push API key)
Formats de réponseJSON

​
Correspondance des sourcemaps

Nous mettrons en correspondance les valeurs des champs name[] avec l’URL complète de la backtrace. Par exemple, la ligne de backtrace suivante :
Shell
  at https://test.local/main.abc123.js:1:92623
Correspondra avec le name : https://test.local/main.abc123.js. Vous pouvez ajouter plusieurs name dans une seule requête curl : 
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'
Notez que vous ne pouvez télécharger qu’un seul fichier de sourcemap à la fois, donc si vous avez plusieurs fichiers de sourcemap, vous devrez envoyer une requête de téléchargement pour chaque fichier séparément. La taille maximale de téléchargement autorisée pour un fichier de sourcemap est de 100MB.

​
Paramètres

Tous les paramètres, à l’exception de file, peuvent être envoyés soit dans le corps POST, soit en tant que paramètres GET. Tous les paramètres sont requis.
ParamètreTypeDescription
push_api_keyStringLa Push API key de votre organisation.
app_nameStringNom de l’application dans AppSignal dans laquelle la sourcemap doit être utilisée.
environmentStringEnvironnement de l’application dans AppSignal dans laquelle la sourcemap doit être utilisée.
revisionStringRéférence de révision du Deploy marker.
nameTableau de chaînesListe des noms de fichiers couverts par la sourcemap. Il doit s’agir d’une URL complète vers le fichier JavaScript minifié, telle que vous la voyez dans la backtrace, y compris les paramètres d’URL.
fileFileSourcemap à télécharger.

​
Réponses

  • L’API renverra un code de statut HTTP 201 en cas de succès.
  • L’API renverra un code de statut HTTP 400 avec une réponse JSON lorsqu’une erreur de validation s’est produite.
  • L’API renverra un code de statut HTTP 404 si aucune application n’existe pour la combinaison nom d’application, environnement et Push API key donnée.
Exemple de corps de réponse 400 : 
{ "errors": ["The following errors were found: Name can't be empty"] }

​
Exemple

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'