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

1. API porque todo Governo
deveria ter uma?
pedrohosilva.wordpress.com.br
@Github @outlook / pedro-hos

2. ~/whois?
Não sou esse

3. ~/whois?

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

6. Cases

7. ● REST Estilo arquitetural criado por Roy
Fielding
● RESTful Design que respeita os
conceitos Rest

8. Tá Fácil

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}

12. Extra API

13. Recursos
( . . . ) /evento/

14. Recursos
( . . . ) /evento/{id}

15. Recursos
( . . . ) /evento/{id}/papers

16. Principais Operações
Mais ou menos isso . .
● POST CREATE
● GET READ
● PUT UPDATE
● DELETE DELETE

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

20. Obrigado