Developers

Aparência

Vai integrar a API REST da Zarv com ajuda de IA? Copie a instrução que aponta o modelo para esta documentação.
Ver a instrução
Você vai integrar a API REST da Zarv. Use a documentação oficial como fonte da verdade.

- Página desta integração: https://developers.zarv.com/api/lens/listUserResearches
- Autenticação Bearer JWT e hosts: https://developers.zarv.com/setup
- Índice das APIs: https://developers.zarv.com/api
- Índice da documentação em markdown: https://developers.zarv.com/llms.txt
- Documentação completa em um arquivo: https://developers.zarv.com/llms-full.txt

Os specs OpenAPI publicados são a fonte da verdade para rotas e schemas — use o spec da API que você escolher antes de escrever qualquer request.

Antes de escrever qualquer código, leia a página desta integração. Siga exatamente os nomes de campos, endpoints, callbacks e formatos que estiverem documentados — não invente parâmetros nem endpoints, e não deduza comportamento a partir de outras APIs que você conhece. Se algo de que você precisa não estiver na documentação, diga que não está em vez de supor.

Minha tarefa: [ex.: escolher a API certa e fazer a primeira chamada autenticada]

Listar casos de um usuário​

GET
/api/v1/lens/{workspaceId}/{userId}/research

Lista os casos abertos por um usuário dentro do workspace, com o mesmo envelope { data, total } da listagem do workspace. O userId do caminho é filtro dentro do workspace autorizado, não identidade: quem autentica continua sendo o token.

Authorizations​

BearerAuth

Token Bearer JWT obtido em POST /api/v1/authentication. O workspace do token precisa ser o mesmo do caminho.

Type
HTTP (bearer)

Parameters​

Path Parameters

workspaceId*

O workspace dono do caso. Tem de ser o workspace do token.

Type
string
Required
Example"3f1a2b4c-5d6e-4f70-8a91-b2c3d4e5f607"
Format
"uuid"
userId*

O autor dos casos.

Type
string
Required
Format
"uuid"

Query Parameters

limit

Tamanho da página. Ausente, zero ou negativo vale 10.

Type
integer
Default
10
offset

Quantos itens pular.

Type
integer
Default
0

Responses​

A página de casos do usuário e o total.

application/json
JSON
{
  
"data": [
  
  
{
  
  
  
"id": "string",
  
  
  
"workspaceId": "string",
  
  
  
"userId": "string",
  
  
  
"domain": "auto",
  
  
  
"objective": "sinistro",
  
  
  
"reportAddress": "string",
  
  
  
"reportText": "string",
  
  
  
"doubts": [
  
  
  
  
"string"
  
  
  
],
  
  
  
"status": "CREATED",
  
  
  
"incidentType": "colisao",
  
  
  
"bot": {
  
  
  
  
"additionalProperties": "string"
  
  
  
},
  
  
  
"kanbanId": "string",
  
  
  
"createdAt": "string",
  
  
  
"updatedAt": "string"
  
  
}
  
],
  
"total": 7
}

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI