Webservice (Autenticação Usuários - Buscar empresas disponíveis para o usuário): mudanças entre as edições
Ir para navegação
Ir para pesquisar
Sem resumo de edição |
Sem resumo de edição |
||
Linha 1: | Linha 1: | ||
'''Descrição:''' Busca as empresas disponíveis para o usuário | |||
'''URL:''' https://[URL]/ws/terceiros/empresas/usuario/{idUsuario} | |||
'''Método:''' GET | |||
'''Entrada:''' Header: ''Token <nowiki>{{token}}</nowiki>, Authorization Basic <nowiki>{{authorization}}</nowiki>,'' Path Param: idUsuario. | |||
'''Saída:''' JSON contendo lista de empresas disponíveis para aquele usuário ou JSON contendo mensagem de erro. | |||
'''Campos JSON de entrada:''' | |||
{| class="wikitable" | |||
|'''Tag''' | |||
|'''Tipo Parâmetro''' | |||
|'''Tipo''' | |||
|'''Obrigatório''' | |||
|'''Observação''' | |||
|- | |||
|Authorization | |||
|header | |||
|String | |||
|SIM | |||
| | |||
|- | |||
|Token | |||
|header | |||
|String | |||
|SIM | |||
| | |||
|- | |||
|idUsuario | |||
|Path Param | |||
|Integer | |||
|SIM | |||
| | |||
|} | |||
'''Exemplo:''' | |||
* '''Envio:''' | |||
** https://[URL]/ws/terceiros/empresas/usuario/{idUsuario} | |||
*** '''Parâmetros adicionais:''' Não possui. | |||
* '''Retorno:''' | |||
** '''Sucesso:'''<syntaxhighlight lang="json" line="1"> | |||
{ | |||
"resposta":[ | |||
{ | |||
"id":1, | |||
"nome":"EMPRESA A", | |||
"nomeFantasia":"EMPRESA A", | |||
"cnpj":"58783342000105" | |||
}, | |||
{ | |||
"id":2, | |||
"nome":"EMPRESA B", | |||
"nomeFantasia":"EMPRESA B", | |||
"cnpj":"16822118000135" | |||
} | |||
] | |||
} | |||
</syntaxhighlight> | |||
** '''Erro:'''<syntaxhighlight lang="json" line="1"> | |||
{ | |||
"error":"Internal Server Error" | |||
} | |||
</syntaxhighlight> | |||
[[Webservice (Autenticação Usuários)|Voltar ao menu Webservice Autenticação Usuários]] | [[Webservice (Autenticação Usuários)|Voltar ao menu Webservice Autenticação Usuários]] |
Edição atual tal como às 13h33min de 17 de maio de 2023
Descrição: Busca as empresas disponíveis para o usuário
URL: https://[URL]/ws/terceiros/empresas/usuario/{idUsuario}
Método: GET
Entrada: Header: Token {{token}}, Authorization Basic {{authorization}}, Path Param: idUsuario.
Saída: JSON contendo lista de empresas disponíveis para aquele usuário ou JSON contendo mensagem de erro.
Campos JSON de entrada:
Tag | Tipo Parâmetro | Tipo | Obrigatório | Observação |
Authorization | header | String | SIM | |
Token | header | String | SIM | |
idUsuario | Path Param | Integer | SIM |
Exemplo:
- Envio:
- https://[URL]/ws/terceiros/empresas/usuario/{idUsuario}
- Parâmetros adicionais: Não possui.
- https://[URL]/ws/terceiros/empresas/usuario/{idUsuario}
- Retorno:
- Sucesso:
{ "resposta":[ { "id":1, "nome":"EMPRESA A", "nomeFantasia":"EMPRESA A", "cnpj":"58783342000105" }, { "id":2, "nome":"EMPRESA B", "nomeFantasia":"EMPRESA B", "cnpj":"16822118000135" } ] }
- Erro:
{ "error":"Internal Server Error" }
- Sucesso: