Archive

  1. Validierung Update

    Kommentare deaktiviert für Validierung Update
    ## Validierung für Update (Service)
    **Für die Aktualisierung von Services existiert eine Validierungslogik, die diverse optionale Felder wie Name, Kategorie, Beschreibung und viele andere überprüft, um sicherzustellen, dass die eingereichten Daten innerhalb definierter Grenzen liegen (z. B. maximale Zeichenlänge, Wertebereich bei numerischen Daten).**
    Die folgenden Felder können im Update-Endpunkt validiert werden:
    
    - `name`: optional, string, max. 255 Zeichen
    - `category_id`: optional,
    - `short_description`: optional, string, max. 255 Zeichen
    - `status`: optional, string, max. 255 Zeichen
    - `statuspercent`: optional, integer, min. 0, max. 100
    - `servicetype`: optional, string, max. 255 Zeichen
    - `content`: optional, string
    - `description`: optional, string
    - `advantages`: optional, string
    - `art_nr`: optional, string, max. 255 Zeichen
    - `user`: optional, string, max. 255 Zeichen
    - `booking`: optional, string
    - `restriction`: optional, string
    - `cancelling`: optional, string
    - `delivery_time`: optional, string, max. 255 Zeichen
    - `delivery_point`: optional, string, max. 255 Zeichen
    - `reporting`: optional, string
    - `servicelevel`: optional, string
    - `servicelevelvalues`: optional, string
    - `serviceprovidercontract`: optional, string
    - `customerspecific`: optional, string
    - `serviceart`: optional, string
    - `plannedchanges`: optional, string
    - `processingpersonaldata`: optional, string
    - `personaldata`: optional, string
    - `processingsensitivpersonaldata`: optional, string
    - `processingpersonaldatalaw`: optional, string
    - `personaldatastorageduration`: optional, string
    - `personaldatatransfer`: optional, string
    - `costs`: optional, integer, min. 0
    
  2. Destroy

    Kommentare deaktiviert für Destroy
    #### 4. Destroy
    **Über die Methode DELETE an der URL /api/services/{id} kann ein Service gelöscht werden. Bei Erfolg wird der Status 200 OK zurückgegeben. Wenn der Service nicht gefunden wird, gibt es einen 404 Not Found Status und bei Serverfehlern einen 500 Internal Server Error.**
    
    - **Methode**: DELETE
    - **URL**: /api/services/{id}
    - **Beschreibung**: Löscht einen spezifischen Service.
    - **Erfolgsantwort**:
    - Status: 200 OK
    - Beispiel:
    ```json
    {
    "status": "success",
    "message": "deleted"
    }
    ```
    - **Fehlerantwort**:
    - Status: 404 Not Found
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Service not found"
    }
    ```
    - Status: 500 Internal Server Error
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Failed to delete service"
    }
    ```
    
  3. Update

    Kommentare deaktiviert für Update
    #### 3. Update
    **Dieser Vorgang erlaubt die Aktualisierung eines Services mittels PUT oder PATCH an der URL /api/services/{id}. Erfolg resultiert in einem 200 OK Status mit der Bestätigung der Aktualisierung. Fehlschläge aufgrund nicht auffindbarer Services führen zu einem 404 Not Found, Validierungsfehler zu einem 422 Unprocessable Entity und Serverfehler zu einem 500 Internal Server Error.**
    
    - **Methode**: PUT/PATCH
    - **URL**: /api/services/{id}
    - **Beschreibung**: Aktualisiert die Details eines spezifischen Services.
    - **Erfolgsantwort**:
    - Status: 200 OK
    - Beispiel:
    ```json
    {
    "status": "success",
    "message": "updated",
    "service": {...}
    }
    ```
    - **Fehlerantwort**:
    - Status: 404 Not Found
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Service not found"
    }
    ```
    - Status: 422 Unprocessable Entity
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Validation failed"
    }
    ```
    - Status: 500 Internal Server Error
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Failed to update service"
    }
    ```
    
  4. Show

    Kommentare deaktiviert für Show
    #### 2. Show
    ** Ebenfalls über GET, aber an der URL /api/services/{id}, können Details eines spezifischen Services abgerufen werden. Bei Erfolg liefert dies ebenfalls einen 200 OK Status. Bei einem nicht auffindbaren Service wird ein 404 Not Found Status zurückgegeben, und bei Serverfehlern ein 500 Internal Server Error.**
    
    - **Methode**: GET
    - **URL**: /api/services/{id}
    - **Beschreibung**: Ruft die Details eines spezifischen Services ab.
    - **Erfolgsantwort**:
    - Status: 200 OK
    - Beispiel:
    ```json
    {
    "status": "success",
    "message": "fetched",
    "service": {...}
    }
    ```
    - **Fehlerantwort**:
    - Status: 404 Not Found
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Service not found"
    }
    ```
    - Status: 500 Internal Server Error
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Failed to fetch service"
    }
    ```
    
  5. Index

    Kommentare deaktiviert für Index
    #### 1. Index
    **Über die Methode GET an der URL /api/services können Benutzer eine Liste aller Services abrufen, die nach dem Erstellungsdatum in absteigender Reihenfolge sortiert ist. Bei Erfolg liefert die API einen 200 OK Status mit einer entsprechenden Erfolgsmeldung und der Liste der Services. Bei einem Serverfehler gibt die API einen 500 Internal Server Error aus.**
    
    - **Methode**: GET
    - **URL**: /api/services
    - **Beschreibung**: Ruft eine Liste aller Services ab, sortiert nach Erstellungsdatum in absteigender Reihenfolge.
    - **Erfolgsantwort**:
    - Status: 200 OK
    - Beispiel:
    ```json
    {
    "status": "success",
    "message": "fetched",
    "services": [...]
    }
    ```
    - **Fehlerantwort**:
    - Status: 500 Internal Server Error
    - Beispiel:
    ```json
    {
    "status": "error",
    "message": "Failed to fetch services"
    }
    ```