O documento discute como criar APIs com Rails de forma simples e descomplicada. Primeiro explica o que é uma API e para que servem. Em seguida, mostra como iniciar um projeto Rails para desenvolver APIs, gerar modelos, usar gems como Active Model Serializer e versionar a API. Por fim, demonstra como gerar controladores e rotas para realizar operações CRUD via requisições HTTP.

1. Criando API’s com Rails
Ricardo Silva
com uma abordagem simples e descomplicada :)

2. Ricardo Silva
/ricardo.b.silva13
@ricardobsilva

3. Tá, mas o que significa API? Para que serve? O que faz?

4. Application Programming Interface
O que significa?
Application Programming Interface ou, em português, “Interface de Programação de Aplicativos”.
fonte: http://www.tecmundo.com.br/programacao/1807-o-que-e-api-.
htm

5. A API serve para interligar diversas funções em uma aplicação (por exemplo, busca de imagens,
notícias, artigos, etc.) de modo a possibilitar que possam ser utilizadas em outras aplicações.
Para que serve?

6. O que faz?

7. JSON

8. Porque usar Rails para desenvolver minhas API’s?

9. Rails é ...
● fácil de aprender
● produtivo
● simples
● divertido
● e quase tão bom quanto as
canções do Oasis

10. Um pouco sobre o Rails (e Ruby)
Ruby é uma linguagem : ruby é uma
linguagem dinâmica e open source com foco
na simplicidade e na produtividade
Rails é um framework : Rails é um framework escrito em Ruby
que facilita o desenvolvimento da sua aplicação web. Rails usa
de forma inteligente as capacidades unicas da linguagem Ruby,
que é o que a torna tão diferente.

11. Chega de teoria,
vamos começar

12. rails new api
rails g model person name:string email:string hability:string local:string obs:text
rake db:migrate
Gerando nossos modelos

13. active model serializer
Gems necessárias
bundle

14. Versionando sua API

15. Criando os diretórios responsáveis
pelo versionamento da API
dentro de controller, criamos:
‘api/v1’
namespace :api , defaults: {format: :json} do
namespace :v1 do
end
end
em ‘config/routes.rb’ crie o caminho que
aponta para versão dos seus serviços

16. Gerando nossos serviços
rails g scaffold_controller 'api/v1/person'

17. alguns ajustes no controller

18. antes depois

19. antes depois

20. antes depois

21. antes depois

22. antes depois

23. antes depois

24. antes depois

25. declarando as rotas

26. em ‘config/routes.rb’

27. primeiros testes

28. [POST] criando um registro

29. esse é o resultado
Ok, criou. Cadê o restante dos dados?

30. Um ultimo ajuste

31. [POST] mais uma vez

32. agora sim ! o/

33. o que mais estudar?
● Arquitetura REST
● Autenticação via TOKEN
● Cliente-servidor
● TDD

34. FIM