Projekte und Deployments auflisten
Jeder Workspace, den ein Konto besitzt, dann jede tatsächlich laufende App, als zwei CouchDB-View-Lesezugriffe.
"Projekte" und "Deployments" beantworten zwei verschiedene Fragen. Ein Projekt ist ein Workspace des
Kontos, das, was du im Projektwechsler siehst, egal ob darin je etwas live gegangen ist. Ein Deployment ist eine App, die tatsächlich
irgendwo läuft, is_deployment: true in ihrem eigenen Dokument. Ein Konto aufzulisten heißt meist beides: zuerst die Workspaces,
dann das, was in jedem davon läuft.
Methoden
Get Account Projects
Returns the projects owned by the account (or all projects for superuser and support accounts) from the user_projects master view.
Get Account Deployments
Returns the deployments associated with the account from the user_deployments master view.
Schritt für Schritt
Die Projekte des Kontos auflisten
Keine Felder außer deinem Schlüssel: Beide Methoden fragen den CouchDB-View über die uid ab, zu der deine Zugangsberechtigung bereits führt.
2. Auflisten, was tatsächlich bereitgestellt ist
Gleiche Form, anderer View: user_deployments gibt ein Dokument nur aus, wenn is_deployment wahr ist,
diese Liste ist also eine Teilmenge aller Apps, die das Konto je erstellt hat, nämlich die mit einer aktiven
Zugriffs-URL.
Die Antwort
Beide Methoden reichen ein CouchDB-View-Ergebnis unverpackt durch: code ist 871 (der feste
Erfolgscode, den get_couch_view immer zurückgibt, nicht das übliche 1), und data ist die rohe nano-View-Antwort,
total_rows, offset und ein rows-Array aus { id, key, value }. id ist die _id des Projekts
(oder Deployments), der Wert, den du bei jedem anderen Aufruf in diesem Abschnitt als app_id übergibst.
Die Zeilen von get_account_deployments enthalten dieselben Felder plus app_hosting_server, app_datacenter_id,
app_hosting und is_deployment: true, da user_deployments diese zusätzlich zum gemeinsamen
Satz ausgibt. app_status_code < 4 ist der einzige Status, den dieser View oder user_projects dir je zeigt: Beide
Map-Funktionen filtern alles ab 4 heraus, ein gelöschtes Projekt verschwindet also einfach, statt
mit einem Status zu erscheinen, den du prüfen müsstest.
get_account_projects setzt main_profile_name auf die Zeile des eigenen Workspace des Kontos, wenn dieser
Workspace ein benanntes Profil hat. Die Zeile, die du als "dein" Projekt zeigst, kann also anders lauten als ihr
gespeicherter app_name. Bevorzuge main_profile_name, wenn vorhanden.
Fehler
Beide Methoden scheitern nur so, wie jeder Aufruf scheitern kann: ein fehlender oder nicht berechtigter api_key (-401,
siehe Fehler). Keine der beiden verzweigt nach app_id oder einer anderen Eingabe, da keine
eine nimmt. Ein leeres rows-Array ist eine echte, erfolgreiche Antwort für ein Konto, das noch nichts in dieser
Liste hat, kein Fehler.