Histórico da Página
...
Apesar de o padrão definido no documento RFC 7230 da especificação do HTTP 1.1 não definir um tamanho máximo para a url, nenhum endpoint deve ser identificado com uma url maior que 2000 caracteres para garantir que todos os navegadores modernos sejam suportados.
...
Consideramos uma API o agrupamento de endpoints que façam parte da mesma unidade de negócio, criar um novo grupo de endpoints implica em preocupações como versionamento, disponibilidade e documentação. Apesar de não definirmos uma estrutura única com uma séria de regras para esses agrupamentos (já que não conseguimos generalizar todas as linhas de negócio) deve-se considerar como regra básica a complexidade necessária para descobrir estes endpoints, ou seja, O agrupamento deve facilitar e não complicar a descoberta dos serviços.
Ex:
Bloco de código | ||
---|---|---|
| ||
GET http://totvs.com/api/ecm/v1/documents GET http://totvs.com/api/bpm/v1/workflows GET http://totvs.com/api/lms/v1/classes |
...