Web Api

Atualmente estou trabalhando bastante com web api, então estou estudando a melhor forma de trabalhar com essa tecnologia.

Começando do princípio, qual a melhor forma de estruturar nossas rotas ?

A ideia é usar a menor quantidade de rotas diferentes, usando (e abusando) dos verbos HTTP.

Tomando por exemplo uma manipulação de cadastro de pessoas, teremos as seguintes rotas:

• /people, que manipulará todo o conjunto de pessoas cadastradas no sistema.
• /people/4261, que manipulará o registro da pessoa de id 4261.

E a partir dessas duas rotas, teremos as ações de listagem, criação, edição e exclusão.

O verbo POST deve ser usado somente para criação de novos registros, para a edição, usa-se o verbo PUT. Para casos de listagem, fazemos um GET, e para remoção, DELETE.

Ilustrando, uma imagem retirada do blog da referência, usando como exemplo a manipulação de cachorros:



* Detalhe: sempre melhor colocar nas rotas um nome no plural, como no exemplo "dogs" ao invés de "dog".

*** Referência: ***
http://blog.apigee.com/detail/restful_api_design_nouns_are_good_verbs_are_bad/

Certificado auto assinado

Estou trabalhando em um sistema que exige SSL.
Hoje tive que gerar um certificado para testa-lo, e eu não podia simplesmente exportar o que está no site de produção...

E aí?

Pelo próprio IIS, podemos ir em Certificados --> Criar Certificado Autoassinado, e gerar seu certificado, porém, por essa forma, não é possível configurar uma série de opções que podemos configurar pelo prompt do Visual Studio.

Então, dando uma googleada, olha aí:

1- Abrir o prompt do VS (por via das dúvidas, abri em modo administrador)
2 - Digitar o comando:

makecert -n "CN=seusite.com.br" -ss my nome_do_certificado_a_gerar.cer -e 12/31/2030

Esse comando cria um certificado para o site seusite.com.br válido até 31 de dezembro de 2030.

O certificado gerado é salvo por default na pasta do prompt, "C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC".

No link da Microsoft há mais várias opções de parâmetros a passar!

Boa diversão!