> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sourcemaps API

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](/front-end/sourcemaps#public-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](/front-end/sourcemaps).

<Warning>
  Private sourcemaps worden niet gebruikt om Node.js-backtraces op te lossen.

  Volg de [Node.js-installatie-instructies](/nodejs/3.x/installation#typescript-support) om uw applicatie zo te configureren dat sourcemap-backtraces worden gegenereerd.
</Warning>

## Sourcemap aanmaken

Met dit endpoint kunt u private sourcemaps aanmaken.

|                        |                                                          |
| ---------------------- | -------------------------------------------------------- |
| Endpoint               | `/api/sourcemaps`                                        |
| Request-methode        | `POST`                                                   |
| Content-Type           | `multipart/form-data`                                    |
| Vereist authenticatie? | Ja ([Push API key](/appsignal/terminology#push-api-key)) |
| Responseformaten       | JSON                                                     |

### Sourcemaps matchen

Wij matchen de waarden voor de `name[]`-velden tegen de volledige backtrace-URL. Bijvoorbeeld, de volgende backtrace-regel:

```shell Shell theme={null}
  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:

<CodeGroup>
  ```bash Bash theme={null}
  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'
  ```
</CodeGroup>

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**.

| Parameter      | Type             | Beschrijving                                                                                                                                                                                       |
| -------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `push_api_key` | String           | De{" "} [Push API key](/appsignal/terminology#push-api-key) van uw organisatie.                                                                                                                    |
| `app_name`     | String           | Naam van de applicatie in AppSignal waarin de sourcemap moet worden gebruikt.                                                                                                                      |
| `environment`  | String           | Omgeving van de applicatie in AppSignal waarin de sourcemap moet worden gebruikt.                                                                                                                  |
| `revision`     | String           | [Deploy marker](/application/markers/deploy-markers){" "} revisiereferentie.                                                                                                                       |
| `name`         | Array of Strings | Lijst 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. |
| `file`         | File             | Te 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:

<CodeGroup>
  ```json JSON theme={null}
  { "errors": ["The following errors were found: Name can't be empty"] }
  ```
</CodeGroup>

### Voorbeeld

<CodeGroup>
  ```bash Bash theme={null}
  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'
  ```
</CodeGroup>
