Lista projekt och distributioner
Varje arbetsyta ett konto äger, sedan varje app som faktiskt körs, som två läsningar av CouchDB-vyer.
"Projekt" och "distributioner" svarar på två olika frågor. Ett projekt är en arbetsyta på kontot,
det du ser i projektväxlaren, oavsett om något i det någonsin har gått live. En distribution är en
app som faktiskt körs någonstans, is_deployment: true på dess eget dokument. Att lista ett konto
betyder oftast båda: först arbetsytorna, sedan det som var och en kör.
Metoder
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.
Genomgång
Lista kontots projekt
Inga fält utöver din nyckel: båda metoderna nycklar CouchDB-vyn på det uid som din inloggningsuppgift redan motsvarar.
2. Lista vad som faktiskt är distribuerat
Samma form, en annan vy: user_deployments ger bara ut ett dokument när is_deployment är sant,
så den här listan är en delmängd av varje app som kontot någonsin har skapat, de som har en
åtkomst-URL som är live.
Svaret
Båda metoderna skickar ett CouchDB-vyresultat rakt igenom, utan omslag: code är 871 (den fasta
framgångskod som get_couch_view alltid returnerar, inte den vanliga 1), och data är det råa
nano-vysvaret, total_rows, offset och en array rows med { id, key, value }. id är
projektets (eller distributionens) _id, det värde du skickar som app_id till varje annat anrop i
det här avsnittet.
Rader från get_account_deployments har samma fält plus app_hosting_server, app_datacenter_id,
app_hosting och is_deployment: true, eftersom user_deployments ger ut dem ovanpå den delade
uppsättningen. app_status_code < 4 är den enda status som den här vyn eller user_projects
någonsin visar: båda map-funktionerna filtrerar bort allt från 4 och uppåt, så ett raderat projekt
slutar helt enkelt visas i stället för att dyka upp med en status att kontrollera.
get_account_projects stämplar main_profile_name på kontots egen arbetsyterad när arbetsytan har
en namngiven profil, så raden du visar som "ditt" projekt kan läsas annorlunda än dess lagrade
app_name. Föredra main_profile_name när det finns.
Fel
Båda metoderna kan bara misslyckas på det sätt som varje anrop kan: en api_key som saknas eller
inte är behörig (-401, se Fel). Ingen av dem förgrenar sig på app_id eller någon
annan indata, eftersom ingen av dem tar någon; en tom array rows är ett verkligt, lyckat svar för
ett konto som inte har något i den listan än, inte ett fel.