API - Application Programming Interface
Documentação API Preventech
Entidades
Retorna uma listagem com todas as entidades. Pode usar filtros de pesquisa passando parâmetros na string de consulta.
URL
https://api.gescorp.pt/api/v1/entities
HEADERS
Accept: application/json
apikey: API_KEY
X-AccessKey: ACCESS_KEY
Parâmetros
Nome | Tipo | Obrigatório | Descrição | Exemplo |
---|---|---|---|---|
method |
string | Método a invocar.* Caso seja enviado a vazio, este irá se comportar como se tivesse sido colocado a opção: "entitiesList"
|
entitiesList |
|
id |
integer | Identificador específico pelo qual pretende procurar uma determinada entidade. | 423451 |
|
type |
string | Identificador específico pelo qual pretende procurar um tipo de entidade. | socio |
|
fiscal_id |
string | Identificador específico pelo qual pretende procurar um número de identificação fiscal. | 999999990 |
|
email |
string | Identificador específico pelo qual pretende procurar um email. | xpto@gmail.com |
|
phone |
string | Identificador específico pelo qual pretende procurar um número de telefone. | 910383855 |
|
active |
boolean | Identificador específico pelo qual pretende procurar se uma entidade está activa. | true |
Responses
200 | SUCCESS Listagem de entidades obtida com sucesso. |
|
401 | AUTHENTICATION ERROR Parâmetros de autentificação incorrectos. |
(Empty Response) |
Example Success Body Response
{
"entities": [
{
"id": "1",
"numero": "#1",
"nome": "Carlos Eduardo Matos",
"tipo": "socio",
"pais": "Portugal",
"morada": "Rua de Goda",
"localidade_morada": "",
"cpostal": "4590-756",
"localidade_postal": "",
"email": "xpto@gmail.com",
"nif": "123456789",
"foto": "https://preventech.pt/img/user_default_small.png"
},
{
"id": "423451",
"numero": "S3",
"nome": "Telmo Silva Leal",
"tipo": "socio",
"pais": "Portugal",
"morada": "",
"localidade_morada": "",
"cpostal": "",
"localidade_postal": "",
"email": "xpto123@gmail.com",
"nif": "",
"foto": "https://preventech.pt/img/user_default_small.png"
},
{
"id": "1995999",
"numero": "P63",
"nome": "João Ferreira Castro",
"tipo": "particular",
"pais": "Portugal",
"morada": "",
"localidade_morada": "",
"cpostal": "xpto12345@hotmail.com",
"localidade_postal": "",
"email": "",
"nif": "",
"foto": "https://preventech.pt/img/user_default_small.png"
}
]
}