Segurança
Para acessar o serviço de pesquisa, a aplicação deve enviar um acess_token, junto ao requisição. Esse acess_token deverá ser obetido da seguinte maneira:
Verbo | POST |
|---|---|
Url | |
Parâmetros |
|
Endpoint |
Uma vez obtido o acess_token após essa requisição no header da requisição de pesquisa deve ser enviado o Autorization : Bearer + {espaço} + acess_token
Endpoint
Para acessar o serviço de pesquisa o sistema deve fazer uma requisição do tipo "GET” no “EndPoint” definido pela “URL Org” da organização
Verbo | GET |
|---|---|
Url org | Endereço fornecido pelo administrador. Exemplo: https://snapproperty-developer-edition.na132.force.com |
Serviço | /services/apexrest/snap_brok/imovel/pesquisar |
Endpoint | https://snapproperty-developer-edition.na132.force.com/services/apexrest/snap_brok/imovel/cidades |
Retorno da pesquisa
Retorno com sucesso
Na tabela abaixo estão descritos os campos retornados pelo serviço quando a pesquisa é realizada com sucesso.
Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
Total | Número | Indica a quantidade total de cidades encontradas com os imóveis disponíveis para locação. | 90 |
Mensagem | String | Mensagem do sistema | "Pesquisa realizada com sucesso" |
cidades | List<snap_finan__Cidade__c> | Lista com os registros da cidades retornados pela pesquisa. | [ { "attributes": { "type": "snap_finan__Cidade__c", "url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a0B00000FibSsQAJ" }, "Id": "a0a0B00000FibSsQAJ", "Name": "Assis" }, { "attributes": { "type": "snap_finan__Cidade__c", "url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000MEBUSQA5" }, "Id": "a0a4P00000MEBUSQA5", "Name": "Belém" }, { "attributes": { "type": "snap_finan__Cidade__c", "url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000LVISkQAP" }, "Id": "a0a4P00000LVISkQAP", "Name": "Natal" }, { "attributes": { "type": "snap_finan__Cidade__c", "url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a0B00000Hm5dtQAB" }, "Id": "a0a0B00000Hm5dtQAB", "Name": "Goiânia" }, { "attributes": { "type": "snap_finan__Cidade__c", "url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000PAojoQAD" }, "Id": "a0a4P00000PAojoQAD", "Name": "Maringá" }, { "attributes": { "type": "snap_finan__Cidade__c", "url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000PoY2sQAF" }, "Id": "a0a4P00000PoY2sQAF", "Name": "ALEGRETE" }, { "attributes": { "type": "snap_finan__Cidade__c", "url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a0B00000HxkNuQAJ" }, "Id": "a0a0B00000HxkNuQAJ", "Name": "Guarulhos" }, { "attributes": { "type": "snap_finan__Cidade__c", "url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a0B00000Hm5cxQAB" }, "Id": "a0a0B00000Hm5cxQAB", "Name": "São Paulo" }, { "attributes": { "type": "snap_finan__Cidade__c", "url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000PAj5hQAD" }, "Id": "a0a4P00000PAj5hQAD", "Name": "Uberlândia" } ] |
Erro | Boolean | FALSE |
|
Exemplo:
| Code Block |
|---|
{
"Total": 16,
"Mensagem": "Pesquisa realizada com sucesso",
"Erro": false,
"cidades": [
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a0B00000FibSsQAJ"
},
"Id": "a0a0B00000FibSsQAJ",
"Name": "Assis"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000MEBUSQA5"
},
"Id": "a0a4P00000MEBUSQA5",
"Name": "Belém"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000LVISkQAP"
},
"Id": "a0a4P00000LVISkQAP",
"Name": "Natal"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a0B00000Hm5dtQAB"
},
"Id": "a0a0B00000Hm5dtQAB",
"Name": "Goiânia"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000PAojoQAD"
},
"Id": "a0a4P00000PAojoQAD",
"Name": "Maringá"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000PoY2sQAF"
},
"Id": "a0a4P00000PoY2sQAF",
"Name": "ALEGRETE"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a0B00000HxkNuQAJ"
},
"Id": "a0a0B00000HxkNuQAJ",
"Name": "Guarulhos"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a0B00000Hm5cxQAB"
},
"Id": "a0a0B00000Hm5cxQAB",
"Name": "São Paulo"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000PAj5hQAD"
},
"Id": "a0a4P00000PAj5hQAD",
"Name": "Uberlândia"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000PoGsRQAV"
},
"Id": "a0a4P00000PoGsRQAV",
"Name": "SANTA MARIA"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a0B00000JdVxnQAF"
},
"Id": "a0a0B00000JdVxnQAF",
"Name": "Rio de Janeiro"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000Pmrp6QAB"
},
"Id": "a0a4P00000Pmrp6QAB",
"Name": "Santa Maria - Ok"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000ME8zFQAT"
},
"Id": "a0a4P00000ME8zFQAT",
"Name": "São José dos Campos"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a0B00000Hm7CQQAZ"
},
"Id": "a0a0B00000Hm7CQQAZ",
"Name": "Aparecida de Goiânia"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000LSb2zQAD"
},
"Id": "a0a4P00000LSb2zQAD",
"Name": "Ferraz de Vasconcelos"
},
{
"attributes": {
"type": "snap_finan__Cidade__c",
"url": "/services/data/v52.0/sobjects/snap_finan__Cidade__c/a0a4P00000LWBtPQAX"
},
"Id": "a0a4P00000LWBtPQAX",
"Name": "Porto Alegre [excluir]"
}
]
} |
Retorno com erro
Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
Total | Número |
| null |
Mensagem | String | Mensagem de erro gerada pelo serviço | "Erro na pesquisa de cidades: Erro na pesquisa de cidades: unexpected token: '100' - linha: 493 na linha 502" |
Cidades | List<snap_finan__Cidade__c> |
| null |
Erro | Boolean | TRUE |
|
Exemplo:
| Code Block |
|---|
{
"Total": null,
"Mensagem": "Erro na pesquisa de cidades: Erro na pesquisa de cidades: unexpected token: '100' - linha: 493 na linha 502",
"Cidades": null,
"Erro": true
} |