Guia de Início Rápido
Siga estes passos para fazer sua primeira chamada à API:
- Obtenha suas credenciais de API (
clientId,clientSecret,x-api-key) e um token de acesso conforme descrito na seção Autenticação. - Escolha uma imagem ou documento PDF que você deseja analisar.
- Envie este documento para uma URL publicamente acessível.
- Construa um corpo de requisição JSON:
- Defina
docsURLpara a URL do seu documento. - Defina
docsMimeTypepara o tipo MIME correto (por exemplo,image/jpegouapplication/pdf). - Decida se você conhece o tipo do documento.
- Si sim, defina
docsType(por exemplo, "cnh") e no arraydocuments, adicione um objeto comnamecorrespondendo adocsTypee asoptionsdesejadas. - Se não, omita
docsType. No arraydocuments, adicione objetos para cada tipo de documento potencial (por exemplo, um para "cnh", um para "rg") com suas respectivasoptionsdesejadas.
- Si sim, defina
- Opcionalmente, adicione um
docsIdpara sua referência.
- Defina
- Envie uma requisição POST para o endpoint desejado (ex:
https://api.viewto.me/docs) com seu corpo JSON e os cabeçalhos de autenticação (Authorization: Bearer SEU_TOKENex-api-key: SUA_API_KEY) e o cabeçalhoContent-Type: application/json. - Inspecione a resposta para dados extraídos.
Exemplo (Requisição POST Genérica para /docs):
# Primeiro, obtenha o token (veja a seção Autenticação)
# Assumindo que você tem SEU_TOKEN_DE_ACESSO e SUA_API_KEY
curl --request POST \
--url https://api.viewto.me/docs \
--header 'Authorization: Bearer SEU_TOKEN_DE_ACESSO' \
--header 'x-api-key: SUA_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"docsMimeType": "image/jpeg",
"docsId": "quickstart-test",
"documents": [
{
"name": "cnh",
"options": ["nomeCompleto", "numeroCpf", "dataNascimento"]
}
],
"docsURL": "SUA_URL_DE_DOCUMENTO_PUBLICA_AQUI"
}'
Substitua SUA_URL_DE_DOCUMENTO_PUBLICA_AQUI, SEU_TOKEN_DE_ACESSO e SUA_API_KEY pelos valores reais.