Doku / Erste Schritte

Authentifizierung

Jede Anfrage enthält Ihren API-Schlüssel in einem Header. Schlüssel sind geheim: Bewahren Sie sie auf Ihrem Server auf.

Schlüssel senden

Senden Sie den Schlüssel im Authorization-Header mit dem Bearer-Schema oder im X-Api-Key-Header. Senden Sie genau einen davon: Eine Anfrage mit beiden wird abgelehnt.

Bearer-Token

GET /v1/drugs?country=de&q=ozempic
Host: api.medifontis.com
Authorization: Bearer mf_live_…

X-Api-Key

GET /v1/drugs?country=de&q=ozempic
Host: api.medifontis.com
X-Api-Key: mf_live_…

Schlüsselformat

Schlüssel beginnen mit mf_live_, gefolgt von 64 Hexadezimalzeichen. Medifontis speichert nur einen SHA-256-Hash Ihres Schlüssels und kann ihn Ihnen daher nicht noch einmal anzeigen: Kopieren Sie ihn, wenn Sie ihn erstellen.

Schlüssel geheim halten

Rufen Sie die API von Ihrem Backend aus auf, nie aus Browser-JavaScript oder einer mobilen App.
Speichern Sie den Schlüssel in einer Umgebungsvariablen oder einem Secret Manager, nicht in der Versionsverwaltung.
Verwenden Sie einen Schlüssel pro Anwendung, damit Sie einen ersetzen können, ohne die anderen anzufassen.

Anfragen aus Ihrem Frontend weiterleiten

Leiten Sie bei einem Suchfeld auf einer Webseite die Suchanfrage über einen eigenen Endpunkt weiter, der den Schlüssel hinzufügt:

Node.js

// Express: the browser calls /api/medicines, your server calls Medifontis.
app.get('/api/medicines', async (request, response) => {
  const params = new URLSearchParams({ country: 'de', q: String(request.query.q || '') })
  const upstream = await fetch(`https://api.medifontis.com/v1/drugs?${params}`, {
    headers: { Authorization: `Bearer ${process.env.MEDIFONTIS_API_KEY}` },
  })
  response.status(upstream.status).json(await upstream.json())
})

Schlüssel ersetzen oder widerrufen

Sie können jederzeit auf der Registrierungsseite einen neuen Schlüssel erstellen. Um einen Schlüssel zu widerrufen, den Sie nicht mehr verwenden, schreiben Sie uns über die Kontaktseite. Kontaktieren Sie uns.