Einleitung
Willkommen zur Dokumentation der CannaMetrics API. Diese API bietet eine umfassende Schnittstelle zur standardisierten Bewertung von Cannabisblüten. Durch die Nutzung dieser API können Entwickler Bewertungen einreichen und detaillierte Analysen basierend auf verschiedenen Qualitätskategorien erhalten.
Unser Ziel ist es, einen einheitlichen Bewertungsprozess zu etablieren, der sowohl Konsumenten als auch Produzenten hilft, die Qualität von Cannabisprodukten objektiv zu beurteilen und zu vergleichen. Die API ist einfach zu integrieren und bietet transparente Ergebnisse, die auf fundierten Bewertungskriterien basieren.
API-Endpunkt
Um auf die CannaMetrics API zuzugreifen, senden Sie eine POST-Anfrage an die folgende URL:
URL: https://api.cannaspektrum.de/
Methode: POST
Content-Type: application/json
Stellen Sie sicher, dass Sie den Content-Type Header korrekt setzen und die Daten im JSON-Format senden.
Anfragedaten
Die API erwartet ein JSON-Objekt im Body der POST-Anfrage. Alle erforderlichen Felder müssen korrekt ausgefüllt sein, um eine erfolgreiche Auswertung zu gewährleisten.
Erforderliche Parameter
strain(String): Name der Cannabisblüte.
Zusätzlich zum Strainnamen müssen die Bewertungen für die einzelnen Unterkategorien angegeben werden. Jede Bewertung sollte als ganze Zahl zwischen 0 und 20 angegeben werden.
Diese Kategorie bewertet die optische Qualität der Blüten.
farbe(Integer): Bewertung der Farbintensität und -vielfalt (0 - 20).bluetenstruktur(Integer): Bewertung der Dichte und Form der Blüten (0 - 20).trimqualitaet(Integer): Bewertung der Sauberkeit des Trims (0 - 20).
Bewertung der olfaktorischen Eigenschaften der Blüten.
intensitaet_aroma(Integer): Bewertung der Stärke des Aromas (0 - 20).komplexitaet(Integer): Bewertung der Vielfalt und Tiefe des Aromas (0 - 20).frische(Integer): Bewertung, wie frisch das Aroma wirkt (0 - 20).
Bewertung des sensorischen Erlebnisses beim Konsum.
anfangsgeschmack(Integer): Bewertung des Geschmacks beim ersten Zug (0 - 20).nachgeschmack(Integer): Bewertung des verbleibenden Geschmacks nach dem Ausatmen (0 - 20).balance(Integer): Bewertung der Ausgewogenheit des Geschmacks (0 - 20).sanftheit(Integer): Bewertung, wie sanft oder kratzig der Rauch ist (0 - 20).
Bewertung der Verarbeitung und Konsumqualität der Blüten.
feuchtigkeitsgehalt(Integer): Bewertung, ob die Blüten zu trocken oder zu feucht sind (0 - 20).brennqualitaet(Integer): Bewertung, wie gut die Blüten beim Konsum brennen (0 - 20).stiele_samen(Integer): Bewertung des Anteils an Stielen und Samen (0 - 20).
Bewertung der psychoaktiven Effekte.
einsetzzeit(Integer): Bewertung, wie schnell die Wirkung einsetzt (0 - 20).dauer(Integer): Bewertung der Dauer der Wirkung (0 - 20).intensitaet_wirkung(Integer): Bewertung der Stärke der Wirkung (0 - 20).qualitaet_wirkung(Integer): Bewertung der Qualität und Art der Wirkung (0 - 20).
Optionale Parameter
manufacturer(String): Name des Herstellers. Standard: "Nicht angegeben".additional_info(String): Zusätzliche Informationen oder Anmerkungen. Standard: "Keine zusätzlichen Informationen."
Antwortformat
Nach erfolgreicher Verarbeitung Ihrer Anfrage gibt die API ein JSON-Objekt mit den Auswertungsergebnissen zurück. Dieses enthält detaillierte Informationen zur Gesamtbewertung und den einzelnen Kategorienoten.
Antwortfelder
strain(String): Name der bewerteten Blüte.manufacturer(String): Name des Herstellers.gesamtbewertung(Float): Gesamtbewertung auf einer Skala von 0 bis 100.qualitaetsstufe(String): Qualitätsstufe basierend auf der Gesamtbewertung.kategorienoten(Objekt): Einzelnoten für jede Hauptkategorie.bewertungen(Objekt): Die von Ihnen eingereichten Bewertungen.additional_info(String): Zusätzliche Informationen oder Anmerkungen.datum(String): Datum der Auswertung.
Beispielantwort
{
"strain": "Beispiel Blüte",
"manufacturer": "Nicht angegeben",
"gesamtbewertung": 85.00,
"qualitaetsstufe": "Großartig",
"kategorienoten": {
"aussehen": 16.25,
"aroma": 17.50,
"geschmack": 18.75,
"aushaertung": 15.00,
"wirkung": 17.50
},
"bewertungen": {
"farbe": 15,
"bluetenstruktur": 18,
"trimqualitaet": 17,
"intensitaet_aroma": 19,
"komplexitaet": 16,
"frische": 18,
"anfangsgeschmack": 20,
"nachgeschmack": 18,
"balance": 17,
"sanftheit": 20,
"feuchtigkeitsgehalt": 15,
"brennqualitaet": 16,
"stiele_samen": 14,
"einsetzzeit": 17,
"dauer": 18,
"intensitaet_wirkung": 17,
"qualitaet_wirkung": 18
},
"additional_info": "Keine zusätzlichen Informationen.",
"datum": "26. September 2023"
}
Beispielanfragen
Unten finden Sie Beispielanfragen in verschiedenen Programmiersprachen, um Ihnen den Einstieg zu erleichtern.
PHP Beispiel
<?php
$data = [
"strain" => "Beispiel Blüte",
"farbe" => 15,
"bluetenstruktur" => 18,
"trimqualitaet" => 17,
// Weitere Parameter...
];
$options = [
"http" => [
"header" => "Content-type: application/json\r\n",
"method" => "POST",
"content" => json_encode($data),
],
];
$context = stream_context_create($options);
$result = file_get_contents('https://api.cannaspektrum.de/', false, $context);
echo $result;
?>
Python Beispiel
import requests
data = {
"strain": "Beispiel Blüte",
"farbe": 15,
"bluetenstruktur": 18,
"trimqualitaet": 17,
# Weitere Parameter...
}
response = requests.post('https://api.cannaspektrum.de/', json=data)
print(response.json())
JavaScript Beispiel
const data = {
strain: "Beispiel Blüte",
farbe: 15,
bluetenstruktur: 18,
trimqualitaet: 17,
// Weitere Parameter...
};
fetch('https://api.cannaspektrum.de/', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
console.log(result);
})
.catch(error => {
console.error('Fehler:', error);
});
Fehlerbehandlung
Die API verwendet HTTP-Statuscodes, um den Erfolg oder Fehler einer Anfrage anzuzeigen. Bei fehlerhaften Anfragen erhalten Sie detaillierte Fehlermeldungen im JSON-Format.
- 400 Ungültige Anfrage: Die Anfrage enthält syntaktische Fehler oder fehlende Felder.
- 405 Methode nicht erlaubt: Es wurde eine andere HTTP-Methode als POST verwendet.
Beispiel einer Fehlermeldung bei fehlenden Feldern:
{
"error": "Fehlende erforderliche Felder: strain, farbe"
}
Protokollbeschreibung
Das CannaMetrics-Bewertungsprotokoll wurde entwickelt, um eine umfassende und objektive Bewertung von Cannabisblüten zu ermöglichen. Es berücksichtigt alle wesentlichen Aspekte, die zur Qualität eines Produkts beitragen und bietet eine transparente und standardisierte Methode zur Bewertung.
Durch die Verwendung dieses Protokolls können Konsumenten fundierte Entscheidungen treffen, und Produzenten erhalten wertvolles Feedback zur Verbesserung ihrer Produkte. Die Ergebnisse werden sowohl numerisch als auch grafisch dargestellt, um eine leicht verständliche Analyse zu ermöglichen.
Bewertungskriterien
Die Bewertung erfolgt in fünf Hauptkategorien, die jeweils mehrere Unterkategorien enthalten. Jede Unterkategorie wird individuell bewertet und gewichtet, um die Gesamtnote zu berechnen. Die Hauptkategorien haben unterschiedliche Gewichtungen, basierend auf ihrer Bedeutung für die Gesamtqualität des Produkts.
Kategorie 1: Aussehen
Das Aussehen ist oft der erste Eindruck eines Produkts und spielt eine wichtige Rolle bei der Wahrnehmung der Qualität. Diese Kategorie umfasst:
- Farbe: Bewertung der Farbintensität und -vielfalt der Blüten. Ein reiches Farbspektrum deutet oft auf eine gute Qualität hin.
- Blütenstruktur: Bewertung der Dichte, Form und Konsistenz der Blüten. Gut strukturierte Blüten sind ein Zeichen für sorgfältigen Anbau und Verarbeitung.
- Trimqualität: Bewertung der Sauberkeit des Trims. Eine gute Trimqualität zeigt, dass unerwünschte Blätter und Stiele entfernt wurden.
Diese Unterkategorien tragen gemeinsam zur Kategorienote für das Aussehen bei, welche wiederum einen Einfluss auf die Gesamtbewertung hat.
Kategorie 2: Aroma
Das Aroma beeinflusst das gesamte Konsumerlebnis maßgeblich. In dieser Kategorie werden folgende Aspekte bewertet:
- Intensität des Aromas: Bewertung, wie stark das Aroma wahrnehmbar ist. Ein intensives Aroma ist oft wünschenswert.
- Komplexität: Bewertung der Vielfalt und Tiefe der Duftnoten. Komplexe Aromen weisen auf ein reichhaltiges Terpenprofil hin.
- Frische: Bewertung, wie frisch und lebendig das Aroma wirkt. Ein frisches Aroma kann auf eine gute Lagerung und Verarbeitung hindeuten.
Die Kombination dieser Faktoren ergibt die Kategorienote für das Aroma.
Kategorie 3: Geschmack und Sanftheit
Der Geschmack und die Sanftheit beim Konsum sind entscheidend für das Genuss-Erlebnis. Bewertet werden:
- Anfangsgeschmack: Bewertung des Geschmacks beim ersten Inhalieren. Ein angenehmer Anfangsgeschmack ist wünschenswert.
- Nachgeschmack: Bewertung des Geschmacks nach dem Ausatmen. Ein angenehmer Nachgeschmack verlängert das positive Erlebnis.
- Balance: Bewertung der Harmonie zwischen verschiedenen Geschmacksnoten. Eine ausgewogene Balance wird bevorzugt.
- Sanftheit: Bewertung, wie sanft oder kratzig der Rauch oder Dampf ist. Sanfter Konsum erhöht den Genuss.
Diese Unterkategorien fließen in die Kategorienote für Geschmack und Sanftheit ein.
Kategorie 4: Aushärtung und Brennqualität
Die Aushärtung und Brennqualität beeinflussen die Effizienz und das Erlebnis beim Konsum. Bewertet werden:
- Feuchtigkeitsgehalt: Bewertung, ob die Blüten optimal getrocknet und ausgehärtet sind. Weder zu trocken noch zu feucht ist ideal.
- Brennqualität: Bewertung, wie gleichmäßig und effizient die Blüten brennen. Gute Brennqualität erleichtert den Konsum.
- Stiele & Samen: Bewertung des Anteils unerwünschter Bestandteile wie Stiele und Samen. Ein geringer Anteil ist wünschenswert.
Die Kategorienote für Aushärtung und Brennqualität ergibt sich aus diesen Unterkategorien.
Kategorie 5: Wirkung
Die Wirkung ist ein zentraler Aspekt für viele Konsumenten. Bewertet werden:
- Einsetzzeit: Bewertung, wie schnell die Wirkung nach dem Konsum eintritt. Eine angemessene Einsetzzeit ist wichtig.
- Dauer: Bewertung der Länge der Wirkung. Eine zufriedenstellende Dauer wird bevorzugt.
- Intensität der Wirkung: Bewertung, wie stark die Wirkung empfunden wird. Hängt von den Vorlieben des Konsumenten ab.
- Qualität der Wirkung: Bewertung des subjektiven Erlebens der Wirkung. Positives Wohlbefinden ist wünschenswert.
Diese Faktoren bestimmen die Kategorienote für die Wirkung.
Diagrammauswertung
Zur Veranschaulichung der Ergebnisse werden die Bewertungen grafisch dargestellt:
- Pentagon-Diagramm (Radar Chart): Dieses Diagramm zeigt die Kategorienoten der fünf Hauptkategorien auf einen Blick. Es verdeutlicht die Stärken und Schwächen des Produkts in den verschiedenen Bereichen.
- Balkendiagramm der Einzelbewertungen: Dieses Diagramm stellt die Bewertungen aller Unterkategorien dar. Es ermöglicht eine detaillierte Analyse und zeigt genau, in welchen Bereichen das Produkt besonders gut oder weniger gut abgeschnitten hat.
Diese grafischen Darstellungen unterstützen das Verständnis der Bewertungsergebnisse und ermöglichen einen schnellen Überblick.
Gewichtung der Kategorien
Jede Hauptkategorie und Unterkategorie hat eine bestimmte Gewichtung in der Gesamtbewertung, basierend auf ihrer Relevanz für die Produktqualität. Zum Beispiel könnte die Wirkung stärker gewichtet sein als das Aussehen, da sie für viele Konsumenten wichtiger ist. Die genauen Gewichtungen sind Teil des Bewertungsmodells und sorgen für eine faire und ausgewogene Gesamtbewertung.
Qualitätsstufen
Basierend auf der Gesamtbewertung wird das Produkt in eine Qualitätsstufe eingeteilt:
- 95 - 100: Außergewöhnlich
- 90 - 94.99: Erstaunlich
- 85 - 89.99: Großartig
- 80 - 84.99: Gut
- 70 - 79.99: Respektabel
- < 70: Unauffällig
Diese Stufen helfen dabei, Produkte klar zu differenzieren und ermöglichen einen schnellen Überblick über die Qualität.
Kontakt
Wir freuen uns über Ihr Interesse an der CannaMetrics API. Bei Fragen, Feedback oder Unterstützung stehen wir Ihnen gerne zur Verfügung.
E-Mail: support@cannaspektrum.de
Website: www.cannaspektrum.de