# Authentifizierung

## Authentifizierung mit API-Key

&#x20;Für den Zugriff auf die API wird ein API-Key benötigt.

{% stepper %}
{% step %}

### API-Key erhalten

Der API-Key wird nach erfolgreichem Onboarding von uns bereitgestellt.
{% endstep %}

{% step %}

### API-Key im Request verwenden

Der API-Key muss bei jedem Request im Header übermittelt werden.

Beispiel:&#x20;

```
curl --location 'https://api.multisource.ch/v2/search/calllookup?source=etb&number=0791234567' \
--header 'Auth-Key: <API-KEY>'
```

{% endstep %}

{% step %}

### Verwaltung des API-Keys

* Der API-Key ist ein sicherheitsrelevanter Schlüssel und muss vertraulich behandelt werden.
* Falls ein Key kompromittiert oder ungültig wird, kann er jederzeit erneuert oder widerrufen werden.
  {% endstep %}
  {% endstepper %}

## POST /api/Auth/AccessToken

>

```json
{"openapi":"3.0.1","info":{"title":"Multisource API","version":"1.0"},"servers":[{"url":"https://api.multisource.ch/v2","description":"Production - v2"},{"url":"https://api.multisource.ch","description":"Production"},{"url":"https://apitep.multisource.ch","description":"Pre-Production Testing"}],"paths":{"/api/Auth/AccessToken":{"post":{"tags":["Authentication"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data"}},"text/json":{"schema":{"$ref":"#/components/schemas/Data"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/Data"}}}},"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"Data":{"type":"object","properties":{"username":{"type":"string","nullable":true},"password":{"type":"string","nullable":true}},"additionalProperties":false}}}}
```
