O documento discute as vantagens de governos terem APIs (interfaces de programação de aplicações) para dados e serviços governamentais, incluindo acelerar parcerias, simplificar integração entre dispositivos, e permitir o desenvolvimento de aplicativos móveis. No entanto, aponta que os dados do governo brasileiro disponíveis online atualmente (data.gov.br) não são acessíveis como uma API, têm documentação fraca e os dados são difíceis de encontrar. Defende que seria benéfico se os dados governamentais fossem expostos de forma
4. API
● Dados ou funções de negócio expostos na internet;
● Acelerar Parcerias;
● Simplificar Integração -> Mobile X Desktop X Web
etc;
● Internet das coisas -> RaspberryPi
● Rest JSON
● Segurança
● Padrão de Acesso
● Fácil Hello Word
● Documentação bem detalhada
5. Cases
Governo, Quanto tem: dados.gov.br
● Desnormalizado;
● Não é API;
● Documentação relativamente Fraca, quando
tem
● Dados são difíceis de encontrar
9. E o Governo?
Seria maravilhoso se os dados estivessem
expostos de uma maneira limpa com uma
documentação acessível e clara!
Poderíamos ajudar de muitas formas!
10. Alguns Padrões
❏ URIs
❏ Resources
❏ Operações
❏ Media Types
❏ Status Code
❏ . . .
11. URI
http:// call4papers-jugvale.rhcloud.com /rest /evento
http://call4papers-jugvale.rhcloud.com/rest/evento/{id}
http://call4papers-jugvale.rhcloud.com/rest/evento/{id}/papers
http://call4papers-jugvale.rhcloud.com/rest/v1/evento/{id}
17. Media Types
● XML: application/xml
● JSON: application/json
● TEXT: application/text
● Binay: image/*, image/jpg, etc. . .
18. Status HTTP
● 1XX - Informacionais
● 2xx - Sucesso
○ 200 - OK
○ 201 - Criado
● 3xx - Redirecionamento
○ 301 - Moved Permanently (Location no Header)
○ 307 - Movido Temporariamente
19. Status HTTP
● 4xx - Erro causados pelo cliente
○ 401 - Não Autorizado
○ 403 - Forbidden
○ 404 - Not Found
● 5xx - Erro originado no server
○ 500 - Internal Server Error
○ 503 - Service Unavaible