Listar projetos e implementações
Todos os espaços de trabalho que uma conta possui e depois todas as apps em execução, como duas leituras de vista CouchDB.
"Projetos" e "implementações" respondem a duas perguntas diferentes. Um projeto é um espaço de
trabalho da conta, aquilo que veria no seletor de projetos, quer algo lá dentro tenha ou não ido
alguma vez para o ar. Uma implementação é uma app que está realmente em execução algures,
is_deployment: true no seu próprio documento. Listar uma conta costuma significar ambos: primeiro os
espaços de trabalho e depois o que cada um tem em execução.
Métodos
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.
Passo a passo
Liste os projetos da conta
Sem campos além da sua chave: ambos os métodos indexam a vista CouchDB pelo uid que a sua credencial já resolve.
2. Liste o que está realmente implementado
Mesma forma, uma vista diferente: user_deployments só emite um documento quando is_deployment é
verdadeiro, por isso esta lista é um subconjunto de todas as apps que a conta alguma vez criou, as que
têm um URL de acesso ativo.
A resposta
Ambos os métodos passam um resultado de vista CouchDB diretamente, sem o embrulhar: code é 871 (o
código de sucesso fixo que get_couch_view devolve sempre, não o habitual 1) e data é a resposta
bruta da vista nano, total_rows, offset e um array rows de { id, key, value }. O id é o
_id do projeto (ou da implementação), o valor que passa como app_id a todas as outras chamadas
desta secção.
As linhas de get_account_deployments trazem os mesmos campos mais app_hosting_server,
app_datacenter_id, app_hosting e is_deployment: true, já que user_deployments os emite além do
conjunto partilhado. app_status_code < 4 é o único estado que esta vista ou user_projects alguma
vez lhe mostrará: ambas as funções de mapeamento filtram tudo o que seja 4 ou superior, por isso um
projeto eliminado simplesmente deixa de aparecer em vez de surgir com um estado para verificar.
get_account_projects regista main_profile_name na linha do próprio espaço de trabalho da conta
quando esse espaço de trabalho tem um perfil com nome, por isso a linha que mostra como o "seu" projeto
pode ler-se de forma diferente do seu app_name guardado. Prefira main_profile_name quando existir.
Erros
Ambos os métodos só falham da forma como qualquer chamada pode falhar: uma api_key em falta ou sem
autorização (-401, consulte Erros). Nenhum deles se ramifica por app_id ou outra
entrada, já que nenhum recebe uma, um array rows vazio é uma resposta real e bem-sucedida para uma
conta que ainda não tem nada nessa lista, não um erro.