# Visão geral

> A API de Evidência anexa a uma transação já enviada os fatos que sustentam a defesa: aceite, acesso, entrega, uso e conversa com o cliente.

Página: https://doc.rapidchargeback.com/canais/evidence/visao-geral/

A API de Evidência registra, numa transação já enviada à Rapid, os fatos que sustentam uma defesa: aceite de termos, acesso ao produto, confirmação de entrega, uso e comunicação com o cliente.

É um canal de **entrada**: você chama a Rapid. O registro fica anexado à transação e é usado na montagem da defesa quando aquela transação vira disputa.

## O que ela não é

- **Não é upload de arquivo.** Cada evidência é um registro JSON com teto de 32 KB. Comprovante em PDF, print e contrato ficam na biblioteca de evidências do painel, não aqui.
- **Não cria transação.** A transação precisa existir antes, enviada pela [API de Transações](https://doc.rapidchargeback.com/canais/transactions/visao-geral/). Se não existir, a chamada volta `404 TRANSACTION_NOT_FOUND`.

## Fluxo resumido

1. Você envia a transação de venda pela API de Transações
2. No seu sistema acontece algo que sustenta a venda: o cliente aceitou os termos, acessou o produto, recebeu a entrega
3. Você registra esse fato com `POST /evidence`, apontando para a transação
4. Se aquela transação virar disputa, a Rapid usa os registros na defesa

## Autenticação

Basic Auth com `client_id:client_secret`, igual aos outros canais. Ver [Autenticação](https://doc.rapidchargeback.com/referencia/autenticacao/).

## Endpoints

| Endpoint | O que faz |
|---|---|
| [`POST /evidence`](https://doc.rapidchargeback.com/canais/evidence/registrar-evidencia/) | Registra uma evidência numa transação |
| [`GET /evidence`](https://doc.rapidchargeback.com/canais/evidence/consultar-evidencias/) | Lista as evidências de uma transação |

## Próximos passos

- [Registrar evidência](https://doc.rapidchargeback.com/canais/evidence/registrar-evidencia/)
- [Consultar evidências](https://doc.rapidchargeback.com/canais/evidence/consultar-evidencias/)