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

# Publiek endpoint - JSON Metrics

Dit API-endpoint wordt geboden om aanvullende metrics aan AppSignal toe te voegen, wanneer een bestaande integratie niet kan worden gebruikt of de gebruikte taal (nog) niet wordt ondersteund.

Dit endpoint is bedoeld voor integraties die geaggregeerde metrics over een korte periode versturen; het verdient de voorkeur om elke 5 seconden één request met 100 metrics te versturen dan 100 requests per 5 minuten met telkens één metric.

## Endpoint

Request-methode: `POST`

| Endpoint                                                                                   | Beschrijving                        |
| ------------------------------------------------------------------------------------------ | ----------------------------------- |
| [https://appsignal-endpoint.net/metrics/json](https://appsignal-endpoint.net/metrics/json) | Accepteert JSON-geformatteerde data |

## URL-parameters

| Parameter | Type   | Beschrijving                                                                                               |
| --------- | ------ | ---------------------------------------------------------------------------------------------------------- |
| api\_key  | String | **Front-end** API-sleutel, te vinden in [App-instellingen](https://appsignal.com/redirect-to/app?to=info). |

```shell Shell theme={null}
https://appsignal-endpoint.net/metrics/json?api_key=<api_key>
```

## Body-parameters

De post-body moet JSON-geformatteerde metrics bevatten, gescheiden door een newline, of als een volledige json-body.

| Parameter  | Type                     | Beschrijving                                                                                           |
| ---------- | ------------------------ | ------------------------------------------------------------------------------------------------------ |
| name       | String                   | Naam van de metric, mag geen spaties of speciale tekens bevatten, bijv. alleen (`[a-zA-Z0-9-_]`)       |
| metricType | String                   | Metrictype, kan een van `[gauge, counter, timing, histogram]` zijn                                     |
| value      | Float                    | (Float) waarde                                                                                         |
| tags       | `Object<String, String>` | Object met tags. Zowel key als value moet een string zijn, bijvoorbeeld: `{ "hostname": "frontend1" }` |

Voorbeeld van een JSON-body

<CodeGroup>
  ```json JSON theme={null}
  [
    {
      "name": "traffic_gauge",
      "metricType": "gauge",
      "value": 19.8,
      "tags": { "hostname": "frontend1" }
    },
    {
      "name": "error_counter",
      "metricType": "counter",
      "value": 10,
      "tags": { "hostname": "frontend1", "disk": "vda" }
    },
    {
      "name": "duration_timing",
      "metricType": "timing",
      "value": 19,
      "tags": { "lambda": "login" }
    },
    {
      "name": "duration_timing",
      "metricType": "histogram",
      "value": 5,
      "tags": { "lambda": "login" }
    }
  ]
  ```
</CodeGroup>

Voorbeeld van een door newlines gescheiden body:

```json JSON theme={null}
{"name": "traffic_gauge", "metricType": "gauge", "value": 19.8, "tags": {"hostname": "frontend1"}}\n
{"name": "error_counter", "metricType": "counter", "value": 10, "tags": {"hostname": "frontend1", "disk": "vda"}}\n
{"name": "duration_timing", "metricType": "timing", "value": 19, "tags": {"lambda": "login"}}\n
{"name": "duration_timing", "metricType": "histogram", "value": 5, "tags": {"lambda": "login"}}\n
```

<Tip>
  **Let op**: dit endpoint is geoptimaliseerd voor grote hoeveelheden verkeer en
  valideert de API-sleutel of payload niet; er wordt een `200` (`OK`)-respons
  geretourneerd zolang de body-grootte binnen de limiet van `200k` ligt. Dit
  betekent niet dat de aanvraag bij ontvangst wordt geaccepteerd.
</Tip>