Items
Solicitar reconexão
Pede uma nova autorização do usuário para um item existente, sem criar outro item.
Use quando o consentimento de um item expirou ou foi negado, ou quando o link de autorização venceu. O item volta a pedir ação do usuário e emite um novo auth.authUrl / auth.consentUrl.
Endpoint
POST /v1/items/:id/request-reconnectParâmetros da URL:
id(string, obrigatório): ID do item
Corpo (opcional):
parameters(object): novos parâmetros de conexão (ex.:{ "cpf": "111.444.777-35" }), validados pelasrulesdo conector. Omita para reaproveitar os atuais.
Exemplo
curl -X POST https://of.openi.com.br/v1/items/$ITEM_ID/request-reconnect \
-H "Authorization: Bearer $OPENI_API_KEY"Resposta de sucesso (200):
{ "status": "success" }Depois, consulte Buscar Item (ou aguarde o webhook ITEM_WAITING_USER_INPUT) e envie o usuário para a nova URL de autorização.
Erros
| Status | Causa |
|---|---|
400 | A última execução teve erro de login: o usuário precisa atualizar os parâmetros de conexão antes. Envie parameters corrigidos. |
400 | parameters não passam nas rules do conector. |
404 | Item inexistente ou de outra aplicação. |
Sandbox
No sandbox, o link de consentimento vale uma hora e aceita uma única decisão. Depois disso, chame este endpoint para emitir um novo.

