insights.read lê o Workforce: como os pilotos do MyPilotIndex se apresentam como mercado, em agregados. Um app de piloto com um grant que tem insights.position lê onde um piloto está em relação à coorte dele.
Leia o Workforce
overview, geography, qualifications, aircraft, score e intent. Cada uma aceita os mesmos filtros da tela de um membro, no máximo três por vez. A referência da API lista esses filtros. Um filtro desconhecido ou repetido, ou um valor fora do vocabulário, responde 400 invalid_request, e um nome fora das seis telas responde 404 not_found.
Como os números são protegidos
O servidor aplica os pisos, então o seu código nunca precisa fazer isso:- Uma coorte abaixo do piso responde
status: "insufficient"e nenhuma seção. - Uma célula abaixo do próprio piso é suprimida, e a fatia que ela tinha aparece em
unpublished_pct. - Um filtro que deixaria poucos pilotos é removido, e a resposta informa isso em
filters.broadened.
schema_version, screen, generated_at e cohort, com o status not_ready.
Mostre a um piloto a posição dele
total_hours, pic_hours, score, type_rating_count, years_experience e international_hours. Cada uma tem um status ok, missing ou insufficient, e percentile e cohort_median só aparecem com ok.
cohort.level diz qual degrau da coorte respondeu, de 1, o mais específico, a 4, todos. A resposta não nomeia o piloto em lugar nenhum.