Entwickler
GraphQL
#Überblick
Der aktuelle GraphQL-Endpoint akzeptiert bewusst nur einen begrenzten Query-Umfang.
#Aktuell unterstützter Umfang
Der Endpoint /api/graphql ist wie die übrige API geschützt. Er erkennt zones, files, stats und nodes und beschränkt alle Ergebnisse auf die authentifizierte Organisation.
Der Parser ist kein allgemeiner GraphQL-Server: Introspection, Mutations, komplexe Fragments und beliebige Felder sind nicht garantiert. Nicht unterstützte Queries liefern errors; Dateien sind derzeit auf 50 begrenzt.
#Query senden
Legen Sie den Querytext in die JSON-Eigenschaft
query.Fügen Sie
variablesnur bei Nutzung hinzu.Prüfen Sie auch bei JSON-Antwort auf
errors.Behandeln Sie fehlende Felder als Inkompatibilität, nicht als angenommenes null.
#Verfügbare Abfragen
Diese Schnittstelle ist eine schreibgeschützte Teilmenge ohne Introspection oder allgemeine Mutationen.
#zones
Alle Zonen der Organisation.
Fields: id name domain isActive isVerified status region publicFilesReady
query {
zones {
id
name
domain
isActive
isVerified
status
region
publicFilesReady
}
}#files
Die ersten 50 sichtbaren Dateien.
Fields: id uuid name size mimeType url publicPath
query {
files {
id
uuid
name
size
mimeType
url
publicPath
}
}#stats
Aggregate der letzten 30 Tage.
Fields: totalRequests totalBandwidth zonesCount filesCount
query {
stats {
totalRequests
totalBandwidth
zonesCount
filesCount
}
}#nodes
Nodes der Organisation ohne IP-Adressen.
Fields: id hostname region status
query {
nodes {
id
hostname
region
status
}
}