Cadastro de pessoa
Adiciona registro de pessoa na garagem.
POST api/pessoas
HEADERS
| CHAVE |
VALOR |
DESCRIÇÃO |
OBRIGATÓRIO |
| Accept |
application/vnd.linkc.com.br; version=1 | Versão da API. | SIM |
| Authorization |
Bearer <TOKEN> |
Token obtido na autenticação |
SIM |
| Content-Type |
application/json |
Tipo de conteúdo do request |
SIM |
PARÂMETROS (BODY)
| CHAVE |
DESCRIÇÃO |
OBRIGATÓRIO |
|
nome |
Nome da pessoa ou razão social da empresa, até 50 caracteres. |
SIM |
|
|
E-mail da pessoa |
NÃO |
|
documento |
CPF/CNPJ da pessoa | SIM |
|
logradouro |
Logradouro do endereço |
NÃO |
|
numero |
Número do endereço |
NÃO |
|
complemento |
Complemento do endereço |
NÃO |
|
bairro |
Bairro do endereço |
NÃO |
|
cidade |
Cidade do endereço |
NÃO |
|
uf |
UF do endereço |
NÃO |
|
cep |
CEP do endereço |
NÃO |
|
telefone |
Telefone da pessoa |
NÃO |
RETORNO EM CASO DE SUCESSO (200 – OK)
| CHAVE |
DESCRIÇÃO |
|
id |
Código da pessoa. |
|
nome |
Nome da pessoa. |
|
documento |
Documento da pessoa. |
|
tipo |
Tipo (pessoa física/pessoa jurídica) |
|
logradouro |
Logradouro do endereço |
|
numero |
Número do endereço |
|
complemento |
Complemento do endereço |
|
bairro |
Bairro do endereço |
|
cidade |
Cidade do endereço |
|
uf |
UF do endereço |
|
cep |
CEP do endereço |
|
telefone |
Telefone da pessoa |
EXEMPLO DE RETORNO EM CASO DE SUCESSO (200 – OK)
{
"pessoa" : {
"id": "73b4cab7-ea27-426c-b247-bf0f006e0f05"",
"nome": "MARIA VITÓRIA OLIVEIRA",
"email": "teste@teste.com",
"documento": "64454846626",
"tipo": "PESSOA FÍSICA",
"logradouro": "RUA TESTE",
"numero": "1",
"complemento": "SL 03",
"bairro": "BAIRRO",
"cidade": "CAMPINAS",
"uf": "SP",
"cep": "11111111",
"telefone": "11999999999"
}
}
OUTROS RETORNOS
| CÓDIGO HTTP |
DESCRIÇÃO |
| 400 |
Caso os parâmetros passados estejam incorretos. |
| 401 |
Caso as credenciais sejam inválidas. |
| 422 |
Caso o documento ou e-mail pertença a outra pessoa |