Skip to content

brunobrolesi/node-ocr-api

Repository files navigation

API REST IMAGE OCR

API REST desenvolvida utilizando o conceito de clean architecture e TDD. A aplicação é capaz de retornar as letras contidas em uma imagem de um captcha.

Pré-requisitos

Antes de começar, você vai precisar ter instalado em sua máquina as seguintes ferramentas:

Você também vai precisar de uma conta na Google Cloud e um projeto utilizando Cloud Vision, um tutorial de como configurar o projeto será exibido a seguir:

🛠 Configuração de um projeto utilizando Cloud Vision

Com uma conta Google Cloud criada, na dashboard principal siga os passos das imagem a seguir para criar um projeto.

alt text

alt text

alt text

Com o projeto criado, agora devemos ir para a dashboard do mesmo, para isso siga os passos das próximas imagens:

alt text

alt text

Agora será necessário adicionar a biblioteca Cloud Vision ao projeto, para isso siga os passos das próximas imagens:

alt text

alt text

alt text

alt text

Com a biblioteca Cloud Vision adicionada, necessitamos de uma conta de serviço para poder utilizar a aplicação, para isso siga os passos das próximas imagens:

alt text

alt text

alt text

alt text

alt text

Com a conta de serviço criada, necessitamos de uma chave para poder realizar as requisições, para isso siga os passos das próximas imagens:

alt text

alt text

Ao finalizar o processo, o download de um arquivo json contendo a chave da aplicação será gerado, renomeie-o para api-key.json e o adicione na raiz do projeto.

🎲 Comandos Para Iniciar Aplicação

# Clone este repositório
$ git clone https://github.com/brunobrolesi/node-ocr-api.git

# Acesse a pasta do projeto no terminal/cmd
$ cd node-ocr-api

# Instale as dependências
$ npm install

# Defina as variáveis de ambiente em um arquivo .env seguindo o exemplo fornecido, pode-se apenas renomea-lo para .env para facilitar o processo
$ mv .env.example .env

# Rode os testes (opcional)
$ npm test

# Rode o comando de build
$ npm run build

# Inicie o projeto
$ npm start

# O servidor iniciará por padrão na porta:3000

🛫 Rotas

Para obter o texto de um determinado captcha, envie a imagem para o endpoint:

localhost:3000/api/letter-captcha

A imagem deve ser enviada no formato multipart/form-data utilizando a chave file

🛠 Tecnologias

As seguintes ferramentas foram utilizadas na construção do projeto:

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published