O documento apresenta uma aula sobre APIs RESTful. Ele discute o que é uma API e REST, características de REST como uso de JSON e HTTP methods, padrões de endpoints e códigos de status comuns. Apresenta também a ferramenta Postman para testar APIs.

1. Hugo de Oliveira Alves
Expert Technology Architect
Aceleração Global #4 everis
O que você precisa saber para construir API’s
verdadeiramente Restful

2. Objetivos da Aula
1. O que é API
2. Rest / Restful
3. Lab: Postman

3. [Nome do palestrante]
[Posição]
[Nome do curso]
[Nome da aula]
Parte 1: O que é API
Aceleração Global #4
everis

4. O Que é API
- Application Program Interface
- Pense em API como a camada que esconde as
regras e possibilita uma comunicação externa
- Facilita muito a integração
- Existem várias metodologias ( ou arquiteturas ),
como por exemplo: SOA, Rest, uso por meio de SDK

5. [Nome do palestrante]
[Posição]
[Nome do curso]
[Nome da aula]
Parte 2: Rest / Restful
Aceleração Global #4
everis

6. Rest / Restfull
Rest: Metodologia / Arquitetura
Restful: API que faz uso do Rest
Características
- Trafego dos dados por JSON ( os antigos ainda usam xml )
- Padronização de endpoint’s
- Uso de HTTP Methods ( Get, Post, Put, Delete )
- Fácil entendimento ao iniciar uma integração

7. Http Methods
Get:
Sempre obtém os dados
Post:
Cria um novo registro ou Recurso
Put:
Atualiza um registro existente
Delete:
Remove um registro existente

8. Padrões
Get:
/api/dev/user
Post:
/api/dev/user
Put:
/api/dev/user/{id}
Delete:
/api/dev/user/{id}

9. Erros comuns
Post:
/api/dev/user/{id}
Post:
/api/dev/user/create
Put:
/api/dev/user
Delete:
/api/dev/user?id=2

10. Status Codes
Geralmente:
2x…. = Sucesso
4x…. = Erro no cliente
5x…. = Erro server side
Referência
www.httpstatuses.com
Status comuns:
200 = OK
401 = Unauthorized
403 = Forbidden
404 = Not found
500 = Internal Server Error
504 = Gateway TImeout

11. [Nome do palestrante]
[Posição]
[Nome do curso]
[Nome da aula]
Parte 3: Lab: Postman
Aceleração Global #4
everis

12. [Nome do palestrante]
[Posição]
[Nome do curso]
[Nome da aula]
Dúvidas?
Aceleração
Global #4 everis