Forma programática de obter todos os endpoints de API para a minha instância?

Acho completamente razoável que a mudança leve tempo. Eu gerenciei Relações com Desenvolvedores na minha última empresa e, meu Deus… levou mais de dois anos para que nossas APIs chegassem a um estado melhorado. Tantas coisas complexas a considerar (e a engenharia odiava a ideia de criar um endpoint estável que não pudesse mudar!)

Acho que mudanças menores podem acontecer ao longo do tempo e em um prazo mais curto também. Admito que não analisei como suas rotas (ou como rotas em Ruby) são definidas — mas presumo que algumas coisas fáceis de resolver poderiam ser tratadas com bastante facilidade. Por exemplo:

Não posso falar por todos, mas sinto que mesmo tendo os endpoints existindo na sua especificação de API atual — mesmo que você não tivesse descrições e exemplos, e mesmo que o modelo de resposta fosse fluido — seria uma grande vitória. Simplesmente saber que algo existe é metade da batalha às vezes.

5 curtidas