Qflow-API: Benutzerdokumentation — powered by conQrete 4.0

Hinweise für Entwickler

Die Schnittstelle ist eine REST-API, die den Zugriff über einen POST-Request ermöglicht. Für jede Anfrage sind folgende Angaben erforderlich:

⚠️ Hinweis: Der Token ist vertraulich zu behandeln und darf nicht öffentlich geteilt oder im Frontend-Code hardcodiert werden.

Beispielaufruf mit curl:

curl -X POST "https://api.conqrete.tech/MODEL NAME/VERSION/" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -F "image=@path/to/your/image.jpg;type=image/jpeg"

Beispielaufruf mit Python:

import requests

# Replace with your API details
API_URL = "https://api.conqrete.tech/MODEL NAME/VERSION/"
API_KEY = 'YOUR_API_KEY'

image_path = "path/to/your/image.jpg"

with open(image_path, "rb") as image_file:
    response = requests.post(
        API_URL,
        headers={'Authorization': f'Bearer {API_KEY}'},
        files={'image': ('image.jpg', image_file, 'image/jpeg')}, 
    )
# Print result
try:
    print(response.json())
except ValueError:
    print(response.text)

Wir empfehlen die Übermittlung von Bilddaten im JPEG Format in UltraXGA (1600x1200, 4:3) oder in Full-HD Auflösung (1920 x 1080, 16:9).




Hinweise zur Anwendung

Ein einziges Foto vom Ausbreitmaß genügt und die conQrete-API ermittelt automatisch eine Vielzahl an Frischbetoneigenschaften.

Die einzige Anforderung an die Bildaufnahme ist, dass der Ausbreittisch vollständig im Bild enthalten sein muss – andernfalls kann eine Ausbreitmaß-Analyse nicht stattfinden. Achten Sie also darauf, dass alle vier Ecken des Tisches im Bild zu sehen sind, z.B. so:

01

Als Ergebnis gibt die API eine Visualisierung der Ausbreitmaßanalyse sowie alle ermittelten Parameter der Frischbetoneigenschaften im JSON-Format zurück (Details siehe unten).

Die Visualisierung kann für eine manuelle Plausibilitätsprüfung der Messung verwendet werden. Ein blauer Tischrahmen wird auf das Bild projiziert, welcher bei korrekt erfolgter Messung den Kanten des Ausbreittisches entsprechen sollte. Der Ausbreitkuchen wird eingefärbt und sollte dem Bereich entsprechen, welche für die Messung des Ausbreitmaßdurchmessers verwendet werden soll.




Rückgabewerte und –format

Die REST-API gibt standardmäßig alle Antworten im JSON-Format zurück (JavaScript Object Notation). Unabhängig davon, ob eine Messung erfolgreich oder nicht-erfolgreich war, besteht jede API-Antwort aus folgenden Bestandteilen:

02

Abbildung 1: Beispiele für die zurückgegebenen Antworten der REST-API im JSON Format. Links: Beispiel für eine erfolgreiche Messung. Rechts: Beispiel für eine nicht-erfolgreiche Messung.

Rückgabefelder im Detail:

Feld Typ Beschreibung Beispiel  
response object Objekt welches die gesamte zurückgegebene Antwort der API enthält    
created_at string ISO 8601-formatierter Datums- und Zeitstempel    
result object Objekt, welches die Auswerteergebnisse des Ausbreitmaßes enthält    
success boolean Gibt an, ob eine Messung stattgefunden hat (true) oder nicht (false), z. B. wenn kein Ausbreittisch im Bild vorhanden ist.    
msg string Statusmeldung mit Details zum Erfolg/Fehlern:
200 – Messung erfolgreich
300 – kein Ausbreittisch im Bild gefunden
400 – Ausbreittisch nicht vollständig sichtbar (eine oder mehrere Ecken fehlen)
500 – Ausbreittisch gefunden, aber kein Betonkuchen detektiert		    
durchmesser_a float / null Durchmesser des Ausbreitkuchen [mm] entlang der einen Tischkante 03  
durchmesser_b float / null Durchmesser des Ausbreitkuchen [mm] entlang der anderen Tischkante 04  
durchmesser float / null Gemittelter Durchmesser [mm] aus durchmesser_a und durchmesser_b    
konsistenz string (Enum) / null Gibt die aus dem durchmesser ermittelte Konsistenzklasse an. Mögliche Werte: F1, F2, F3, F4, F5 und F6    
groesstkorn int (Enum) / null Gibt das aus dem Bild ermittelte Größtkorn [mm] an. Mögliche Werte: 8, 16, 32    
sieblinie string (Enum) / null Gibt eine grobe Einschätzung der Siebline (Achtung: dient nur als Richtwert, mit Ungenauigkeiten behaftet). Mögliche Werte: A, AB, B, BC, C    
shapeMetrics object Objekt mit alternativen Beschreibungen des Durchmessers und zusätzlichen Form-Parametern, die die Form und Ausprägung des Ausbreitkuchens beschreiben    
.f_max float / null Maximaler Durchmesser [mm] der um den Ausbreitkuchen gelegten rotierten best-fit Bounding Box. Entspricht der längeren Seite der Box. Kann abweichen von durchmesser_a bzw. durchmesser_b, je stärker die Form des Ausbreitkuchens von einem perfekten Kreis abweicht und je stärker die Orientierung des Ausbreitkuchens zu den Seiten des Tisches verdreht ist 05  
.f_min float / null wie .f_max, allerdings bezogen auf die kürzere Seite der rotierten Bounding Box 06  
.x_A float / null Kreisäquivalenter Durchmesser des Ausbreitkuchens. Definiert als der Durchmesser eines Kreises mit derselben Fläche A wie der Ausbreitkuchen:

\(x_A = \sqrt{\frac{4A}{\pi}}\)		 09  
.circularity float / null Maß für die Kreisähnlichkeit des Segments. Der Wert liegt zwischen 0 und 1, wobei 1 einem perfekten Kreis entspricht. Der Wert berücksichtigt sowohl die Fläche (A) als auch die Glattheit des Umfangs (U) des Ausbreitkuchens:

\(circularity = \frac{4 \pi A}{U^2}\)		    
.compactness float / null Maß für die Kompaktheit des Ausbreitkuchens. Wertebereich von 0 bis 1, wobei 1 einem perfekten Kreis entspricht. Bewertet die Kreisähnlichkeit basierend auf der Gesamtform, nicht nur dem Umfang:

\(compactness = \frac{\sqrt{\tfrac{4A}{\pi}}}{f_{max}} = \frac{x_A}{f_{max}}\)		    
.solidity float / null Maß für die Konkavität (Eindellungen) des Ausbreitkuchens. Definiert als Verhältnis zwischen der Kuchenfläche (A) und der Fläche der konvexen Hülle (A_c). Wertebereich: 0 (stark eingedellt) bis 1 (keine Einbuchtungen, wie z. B. bei einem Kreis) :

\(solidity = \frac{A}{A_c}\)		 10  
.convexity float / null Maß für die Konvexität des Ausbreitkuchens. Definiert als das Verhältnis zwischen dem Umfang der konvexen Hülle (U_c) und dem tatsächlichen Umfang des Ausbreitkuchens (U). Wertebereich: 0 bis 1, wobei 1 einer perfekten konvexen Form (z. B. Kreis) entspricht:

\(convexity = \frac{U_c}{U}\)		    
.extent float / null Maß für die Raumausfüllung des Ausbreitkuchens. Definiert als das Verhältnis der Ausbreitkuchenfläche (A) zur Fläche der rotierten best-fit Bounding Box (siehe f_max und f_min). Wertebereich: 0 bis 1.

\(extent = \frac{A}{f_{max} \cdot f_{min}}\)		    
.eccentricity float / null Maß für die Exzentrizität des Ausbreitkuchens. Beschreibt, wie „elliptisch“ oder „langgestreckt“ der Kuchen ist. Wertebereich: 0 bis 1, wobei 0 einem perfekten Kreis entspricht und 1 einer extrem gestreckten Ellipse (Strichform).    
.irregularity float / null Maß für die Unregelmäßigkeit der Ausbreitkuchenform. Wertebereich: 0 (perfekte, glatte, konvexe Form) bis 1 (maximal unregelmäßige Form mit rauem Rand und Einbuchtungen). Berechnet als

\(irregularity = 1 - (circularity \times solidity)\)		    
.radial_var float / null Maß für die radiale Formabweichung – berechnet als Verhältnis der Varianz der Abstände der Randpunkte zum Massenschwerpunkt zur mittleren Entfernung (radial_mean_diameter). Gibt an, wie stark die Randabstände streuen.    
.radial_mean_diameter float / null Mittlere Entfernung aller Randpunkte zum Massenschwerpunkt des Ausbreitkuchens. Gibt einen durchschnittlichen „Radius“ an – eine Art mittlerer Formdurchmesser. 11  
processed_image string(Base64) Kodiertes Rückgabebild (Base64-kodiert als UTF-8-String), enthält die Visualisierung der KI-basierten Ausbreitmaßanalyse. Kann für einen manuellen Plausibilitäts-Check genutzt werden. Im Fall einer nicht erfolgreichen Messung wird das originale Bild zurückgegeben 12  
thumbnail string(Base64) / null Kodiertes Rückgabebld (Base64-kodiert als UTF-8-String), enthält den perspektivisch korrigierten Ausschnitt des Ausbreittisches inkl. Visualisierung der Messung 13  
Thumbnail_unmasked string(Base64) / null Kodiertes Rückgabebld (Base64-kodiert als UTF-8-String), wie thumbnail, aber ohne eingefärbten Ausbreitkuchen 14  
request_path string Genutzte Endpoint-URL    
request_size int Datengröße der übermittelten Datei    
request_method string Genutze Request Methode der REST-API    
response_time float Dauer der Response in [s]    

Logo
conqrete.tech
mail@conqrete.tech