1. Padrão REST determina endpoints com resources no plural
2. Endpoint de Criar um novo compartilhamento consta um parâmetro id desnecessário

http://polls.apiblueprint.org/compartilhamento/id

3. Endpoint de Recuperar lista de compartilhamentos consta um parâmetro id que na verdade é o id do usuário. Deveria ser /compartilhamentos/usuario/id?page=

http://polls.apiblueprint.org/compartilhamento/id?page=

4. Endpoint de Recuperar lista de compartilhamentos não lista o parâmetro de id/user_id em Parameters
5. Endpoint de Recuperar lista de compartilhamentos não determina quantos compartilhamentos terão por página