Pular para o conteúdo principal
Sourcemaps são usados para obter o número original de linha e coluna a partir de um backtrace que aponta para um arquivo minificado ou transpilado. Recomendamos usar sourcemaps públicos sempre que possível. Builds que produzem muitos sourcemaps podem demorar bastante para serem enviados pelo nosso endpoint privado de sourcemaps. Esta API fornece uma forma fácil de enviar sourcemaps privados para uso com erros de frontend.
Sourcemaps privados não serão usados para resolver backtraces do Node.js.Siga as instruções de instalação do Node.js para configurar sua aplicação para emitir backtraces com sourcemap.

​
Criar sourcemap

Este endpoint permite a criação de sourcemaps privados.
Endpoint/api/sourcemaps
Método da requisiçãoPOST
Content-Typemultipart/form-data
Requer autenticação?Sim (Push API key)
Formatos de respostaJSON

​
Correspondência de sourcemaps

Vamos comparar os valores dos campos name[] com a URL completa do backtrace. Por exemplo, a seguinte linha de backtrace:
Shell
  at https://test.local/main.abc123.js:1:92623
Corresponderá a name: https://test.local/main.abc123.js. Você pode adicionar vários names em uma única requisição 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'
Observe que você só pode enviar um arquivo de sourcemap por vez; portanto, se tiver vários arquivos de sourcemap, terá que enviar uma requisição de upload para cada arquivo separadamente. O tamanho máximo de upload permitido para um arquivo de sourcemap é 100MB.

​
Parâmetros

Todos os parâmetros, exceto file, podem ser enviados no corpo POST ou como parâmetros GET. Todos os parâmetros são obrigatórios.
ParâmetroTipoDescrição
push_api_keyStringA Push API key da sua organização.
app_nameStringNome da aplicação no AppSignal na qual o sourcemap deve ser usado.
environmentStringAmbiente da aplicação no AppSignal no qual o sourcemap deve ser usado.
revisionStringReferência de revisão do Deploy marker.
nameArray of StringsLista de nomes de arquivos que o sourcemap cobre. Esta deve ser uma URL completa para o arquivo JavaScript minificado, como você vê no backtrace, incluindo quaisquer parâmetros de URL.
fileFileSourcemap para upload.

​
Respostas

  • A API retornará um código de status HTTP 201 se for bem-sucedida.
  • A API retornará um código de status HTTP 400 com uma resposta JSON quando ocorrer um erro de validação.
  • A API retornará um código de status HTTP 404 se não existir um app para a combinação fornecida de app name, environment e Push API key.
Exemplo de corpo de resposta 400: 
{ "errors": ["The following errors were found: Name can't be empty"] }

​
Exemplo

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'