Para saber mais sobre a política de privacidade de Joda Tecnologia, veja mais detalhes aqui.

O serviço Pessoa

O cadastro de pessoas, em Joda API, é tratado como um Serviço. Assim como qualquer outro serviço, ele é composto de ações.

Veja as ações mais comuns para o cadastramento de pessoa:

Criar Pessoa/pessoa/criar.phpPúblico
Excluir Pessoa/pessoa/excluir.phpRestrito
Ler Pessoa/pessoa/ler_um.phpPúblico
Listar Pessoas/pessoa/listarPúblico
Pesquisar Pessoa/pessoa/pesquisar?s=xxxxPúblico
Ligar Usuário/pessoa/ligar-usuario.phpRestrito

Exemplo de requisição:

1
https://www.joda.com.br/pessoa/criar.php

Veja o código da requisição no Postman:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
POST /pessoa/criar.php HTTP/1.1
Host: www.joda.com.br
Content-Type: application/json
Proxy-Authorization: Basic xxxxxxxxxxxxxxxxxxxxxxx=
Authorization: Basic xxxxxxxxxxxxxxxxxxxx
User-Agent: PostmanRuntime/7.18.0
Accept: */*
Cache-Control: no-cache
Postman-Token: c7d6e45a-7426-4bd5-b6e1-f53b14973dfa,2cf4d6bf-ded5-4c56-994e-3dbdb3852069
Host: joda-api-php-1.appspot.com
Accept-Encoding: gzip, deflate
Content-Length: 357
Connection: keep-alive
cache-control: no-cache
 
{
	"nome":"Joda Stozo",
	"descricao": "CEO de Joda Tecnologia",
	"jwt": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

Exemplo de resultado:

1
2
3
4
5
{
    "id": "1",
    "nome": "Joda Stozo",
    "descricao": "CEO de Joda Tecnologia"
}

Anote o valor de “id”, você poderá precisar dele mais adiante.

Se ao acionar a API com a ação ‘Criar Pessoa’ você recebeu um retorno parecido com o mostrado acima, parabéns! Você fez o cadastramento de uma pessoa na Joda API.

Atenção: a primeira Pessoa a ser cadastrada por um Usuário de Nível Zero deve ser ela mesma.

Se o Usuário Logado (contido no Token de Login) for de Nível Zero, o seu acesso está limitado apenas a ação ‘Criar Pessoa’. Ao acionar a ação ‘Criar Pessoa’, o usuário de Nível Zero será vinculado à pessoa recém criada. Esse vínculo promove o nível de identificação do usuário para o nível Um.

Ao criar um vínculo com uma cadastro de Pessoa, o Usuário complementa os seus dados. Assim o seu nível de acesso será elevado. Isso torna necessário refazer o Login (obter outro Token de Login).

Se ao criar uma Pessoa, você receber um retorno parecido com mostrado abaixo, seu vínculo ao cadastro de Pessoa está feito.

1
2
3
4
5
6
7
{
    "id": "1",
    "nome": "Joda Stozo",
    "descricao": "CEO de Joda Tecnologia",
    "nivel": "1",
    "message": "Pessoa ligada ao Usuário"
}

Se ao criar uma Pessoa, você receber uma mensagem do tipo : Não foi possível elevar o nível de identificação do Usuário. ou Não foi possível ligar Pessoa ao Usuário. Talvez seja necessário seguir o passo ‘Ligando a Pessoa a um Usuário’.

Se o objetivo do cadastramento da Pessoa não foi o de realizar o Login na API, e assim obter um Token de Login ou se ao criar uma Pessoa a API fez o vínculo com o Usuário, você pode pular este passo.


Ligando a Pessoa a um Usuário

Este passo é necessário quando a pessoa foi criada para identificar um Usuário. O nível de identificação do usuário depende da quantidade de informações cadastradas no Serviço ‘Pessoa’. Todo Usuário é uma Pessoa. Mas nem toda Pessoa é um Usuário. Outra cardinalidade é que uma Pessoa pode estar ligada a mais de um Usuário. Mas um Usuário somente pode estar ligado a uma única Pessoa.

Atenção: se uma Pessoa for ligada a um Usuário que possua uma ligação prévia com outra Pessoa, esse vínculo será substituído e a informação anterior será perdida.

A mesma Pessoa poderá ser vinculada a mais de um Usuário sem perder nenhuma informação.

Requisição HTTP à API para vincular Pessoa ao Usuário:

1
https://www.joda.com.br/pessoa/ligar-usuario.php

ou, no serviço Usuário:

1
https://www.joda.com.br/usuario/ligar-pessoa.php

No corpo da requisição deve conter a informação JSON:

1
2
3
4
5
{
	"pessoaID":1,
	"usuarioID":1,
	"jwt": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

Onde:

  • pessoaID é o valor de id obtido no cadastramento de Pessoa;
  • usuarioID é valor de id obtido no cadastramento de Usuário;
  • e jwt é o valor obtido na ação de Login

Acesso: Se o Usuário (contido no Token de Login) for de Nível Zero, somente a ele poderá ser ligada a Pessoa. Ou seja o usuarioID tem que ser igual ao id contido no Token de Login.


Deixe seu comentário

Fechar Menu
×
×

Carrinho