---
# System prepended metadata

title: carimbo-api

---

# carimbo-api
> Owners: edu.bento (me)

## Timeline


> [17/07 - 19/07] - week1
 ~~[17/07] A1 > POO~~
~~[18/07] A2 > POO
[19/07] A3 > POO~~

>[22/07 - 26/07] - week2
~~[22/07] A5 > HTML + CSS
[23/07] A6 > endoint para TELA 1 [cliente]
[24/07] A7 > Javascript consumir~~
[25/07] A8 > DAO/Spring Data
[26/07] A9 > React + TELA 2

>[29/07 - 02/08] - week3
[29/07] A10 > TELA 2 + React
[30/07] A11 > endpoint para TELA 2 [carimbo]
[01/08] A12 > (DB)
[02/07] A13 > (DB)
[03/08] - Teste



## endpoint cliente [TELA 1]
### cliente [POST] - **registra um cliente**
>url: `project-a/api/cliente`, method: `POST`
>**RequestBody:**
```JSON
{ 
    "cpf": "41377766621"
}
```
>**Response:**
```
httpStatus 200 ok - criado com sucesso. 
httpStatus 403 fail - já existe.
```
### cliente [PUT] - **add more 1 carimbo**
>url: `project-a/api/cliente`, method: `PUT`
>**RequestBody:**
```JSON
{ 
    "cpf": "41377766621"
}
```
>**Response:**
```JSON
httpStatus 200 ok - 'adicionado com sucesso'.
httpStatus 403 fail - 'não foi possível adicionar'.
obs: response não terá retorno, apenas o httpStatus.
```

## endpoint carimbo [TELA 2]
### carimbo [GET] **find**
> url: `project-a/api/cartao/{cpf}`, method: `GET`
> **PathVariable:**
```JSON
carimbo/41377766621
```
>**ResponseBody [status 200]**
```JSON
{
    cpf: "41377766621",
    carimbos: 3,
    carimbos_max: 9
}
```
>**Response [status 403]**
> fail

-- add method to **resgatar** carimbo
>url: `project-a/api/carimbo`, method: `PUT`
>**RequestBody [status 200]**
```JSON
{ 
    cpf: '41377766621'
}
```
>**ResponseBody [status 200]**
```JSON
Resgatado com sucesso!
```
>**ResponseBody [status 403]**
```
httpStatus 403 fail - 'não foi possível adicionar'.
obs: response não terá retorno, apenas o httpStatus.
```

