​

Fehlerbehandlung

​

HTTP-Statuscodes

​

Fehlerantwort-Formate

​

Standardfehler

{
  "error": "Resource not found"
}

• "Resource not found" — Ressource existiert nicht oder Sie haben keinen Zugriff
• "Bad request" — Allgemeiner Fehler; der Grund wird nur in den Protokollen von RxScale festgehalten, nicht in der Antwort. In der External Pharmacy API deckt er auch Anfragen ab, die RxScale ablehnt, etwa die Statusänderung einer stornierten Bestellung — siehe Fehlerantworten der External Pharmacy API
• "Missing required parameters: from and to" — Spezifische Information über fehlende Parameter

​

Authentifizierungsfehler

{
  "code": "authorization_header_missing",
  "description": "Authorization header is expected"
}

​

Validierungsfehler

{
  "error": {
    "shop_uid": ["Missing data for required field."],
    "quantity": ["Not a valid integer."]
  }
}

​

Fehlerantworten der External Pharmacy API

• Anfragen, die RxScale ablehnt, zum Beispiel die Statusänderung einer stornierten Bestellung;
• bei Endpoints mit Anfragekörper (außer complete_order) einen Anfragekörper, der kein gültiges JSON ist oder ohne Content-Type: application/json gesendet wird;
• einen gruppenweiten API-Schlüssel ohne pharmacy_uid oder mit einer pharmacy_uid außerhalb seiner Apothekengruppe.

• {"error": ["Invalid JSON in request body"]} — der Anfragekörper ist kein gültiges JSON. Hier ist error eine Liste.
• {"error": {...}, "pharmacy": {"uid": "...", "display_name": "..."}} — der Anfragekörper hat die Validierung nicht bestanden, zum Beispiel wegen eines nicht unterstützten carrier. pharmacy nennt die Apotheke, für die die Anfrage gestellt wurde.
• {"error": "<message>"} — Sie haben Tracking-Links für eine bereits abgeschlossene Bestellung gesendet.

​

Häufige Fehlerszenarien

curl https://api.rxscale.com/v1/management/products

{
  "code": "api_key_missing",
  "description": "API key header is expected"
}

{
  "code": "permission_denied",
  "description": "API key lacks required permission: <permission>"
}

{
  "error": "Permission denied"
}

{
  "error": "Resource not found"
}

{
  "error": {
    "patient_data": {
      "first_name": ["Missing data for required field."],
      "date_of_birth": ["Not a valid integer."]
    }
  }
}

{
  "error": "Pharmacy SKU already exists"
}

{
  "error": "Request body too large"
}

Content-Type: text/html; charset=utf-8

<!doctype html>
<html lang=en>
<title>429 Too Many Requests</title>
<h1>Too Many Requests</h1>

​

Bewährte Praktiken