Upgrade to Pro — share decks privately, control downloads, hide ads and more …

RESTfull o mito!

RESTfull o mito!

Desmistificando RESTfull

More Decks by Rafael Henrique da Silva Correia

Other Decks in Technology

Transcript

  1. Rafael Henrique da Silva Correia @rafaelhenrique http://blog.abraseucodigo.com.br - Desenvolvedor Python

    na CargoBR - “Coordenador/instrutor” do Grupo de Estudos Python Sorocaba - Membro do GruPy-SP - Aspirante a Mestre em Ciências da Computação - Viciado em World of Warcraft (for the horde!) - Palestrante nas horas que sobram Eu
  2. O que é REST? • REST é um padrão de

    arquitetura de aplicações Web que visa a comunicação entre aplicações • Aplicações não são pessoas! HTML não serve para REST! • Dados transferidos em formato JSON (geralmente) • Códigos de status/retorno comuns do protocolo HTTP • Abstrai linguagem de programação
  3. O que é JSON? (um parente muito próximo do dict

    Python) • Uma “formatação de texto estruturado” • Dados de um livro estruturado em JSON: { "title": "Fluent Python", "tags": ["book", "python", "ramalho"], "authors": ["Luciano Ramalho"], "publishing": "O’reilly" }
  4. E que raios é RESTful? RESTful é apenas a capacidade

    de fazer REST E o RESTo é o RESTo ... (risos) Fonte: http://pt.stackoverflow.com/questions/45783/o-que-%C3%A9-rest-e-restful
  5. O que é API? • Um sistema criado para troca

    de dados entre sistemas que pode usar REST ou não (visto que ainda INFELIZMENTE é possível usar SOAP hoje em dia ou outros bichos piores) Fonte: Eu mesmo, passível de erros por formalidade!
  6. É possível aprender REST? Só é possível por hipótese ou

    é possível mesmo? Sim é possível mesmo! DICA: Se você conhecer um pouco de HTTP é mais fácil ainda
  7. • GET - Pegar/pesquisar coisas • POST - Criar coisas

    • PUT - Atualizar coisas • DELETE - Desabilitar/remover coisas • PATCH (extra) - Atualizações parciais • OPTIONS (extra) - Listar métodos/verbos suportados Os verbos/métodos HTTP (AÇÕES) O que eu consigo mandar uma aplicação fazer pra mim? http://www.restapitutorial.com/lessons/httpmethods.html
  8. Códigos de retorno HTTP O server troca idéia com você!

    • 2XX ◦ 200 OK ◦ 201 Created ◦ 202 Accepted ◦ 204 No Content • 4XX ◦ 400 Bad Request ◦ 401 Unauthorized ◦ 403 Forbidden ◦ 405 Method Not Allowed • 5XX ◦ 500 Internal Server Error ◦ 502 Bad Gateway ◦ 503 Service Unavailable
  9. • 2XX ◦ 200 OK ◦ 201 Created ◦ 202

    Accepted ◦ 204 No Content • 4XX ◦ 400 Bad Request ◦ 401 Unauthorized ◦ 403 Forbidden ◦ 405 Method Not Allowed • 5XX ◦ 500 Internal Server Error ◦ 502 Bad Gateway ◦ 503 Service Unavailable Galerinha do “deu bom” Galerinha do “fica ligado!” Galerinha do “deu ruim” Códigos de retorno HTTP O server troca idéia com você!
  10. • /v1/books • /v1/books/ID-SECRETO-1 • /v1/books/ID-SECRETO-1/author • /v1/books/ID-SECRETO-1/author/ID-SECRETO-2 Os recursos/url

    (A COISA EM SI) Quais as coisas que eu tenho na aplicação? No lugar de ID-SECRETO-1 e ID-SECRETO-2 prefira usar UUID, mas nunca use sequências numéricas!
  11. • /v1/books • /v1/books/ID-SECRETO-1 • /v1/books/ID-SECRETO-1/author • /v1/books/ID-SECRETO-1/author/ID-SECRETO-2 Os recursos/url

    (A COISA EM SI) Quais as coisas que eu tenho na aplicação? No lugar de ID-SECRETO-1 e ID-SECRETO-2 prefira usar UUID, mas nunca use sequências numéricas! UUID é um código mais ou menos assim: ada36620-9aaa-4e9c-a73d-62bf23cf750e 32 dígitos hexadecimais em caixa baixa
  12. Juntando a coisa com a ação! Unindo os pauzinhos •

    POST /v1/books • GET /v1/books/ID-SECRETO-1 • PUT /v1/books/ID-SECRETO-1/author • DELETE /v1/books/ID-SECRETO-1/author/ID-SECRETO-2 Exercício de entendimento: Olhando ai, o que faz cada um desses caras dentro da nossa API? Necessário o envio de dados
  13. Juntando a coisa com a ação! Unindo os pauzinhos •

    POST /v1/books • GET /v1/books/ID-SECRETO-1 • PUT /v1/books/ID-SECRETO-1/author • DELETE /v1/books/ID-SECRETO-1/author/ID-SECRETO-2 o primeiro cria um livro! o segundo busca um livro! o terceiro atualiza um autor de um livro com ID-SECRETO-1! o quarto apaga o autor ID-SECRETO-2 do livro ID-SECRETO-1! Necessário o envio de dados
  14. Juntando a coisa com a ação! Unindo os pauzinhos •

    Levando em conta a criação de um livro via POST o “payload” JSON é similar ao abaixo: { "title": "Fluent Python", "tags": ["book", "python", "ramalho"], "authors": ["Luciano Ramalho"], "publishing": "O’reilly" }
  15. Show me the code! And shut up! API simples de

    livraria em Flask: https://github.com/rafaelhenrique/library_api Baseado em: https://blog.miguelgrinberg.com/post/designing-a-restful-api-with-python-and-flask
  16. O que preciso estudar para aprender mais? • HTTP ◦

    Status codes (códigos de retorno) ◦ HTTP Messages/HTTP Verbs (GET, POST, PUT, DELETE… etc) ◦ Headers ◦ Mimetypes • REST ◦ Resources, Verbs, Querystring... • Flask - framework Python • curl - para fazer suas requisições “manuais”
  17. Links Python Sorocaba * Confira também o nosso canal no

    youtube http://bit.ly/youtube-python-sorocaba * Quer bater um papo "real-time" entre no nosso slack https://grupopythonsorocaba.herokuapp.com/ * Confira próximos eventos presenciais https://www.meetup.com/pt-BR/Grupy-SP/ * Nosso github https://github.com/python-sorocaba