Code Monkey home page Code Monkey logo

nodejs-api-starter's Introduction

Server API

Create development server

Steps

  • Run npm install.
  • Copy file env.template to .env.development.
  • Run docker-compose up --build.

Development server

Run docker-compose up for a dev server. Navigate to http://localhost:8000/. The API will automatically reload if you change any of the source files.

Structure Project

app/
|
|– Configs
|
|– Configs
|   |– environment.js
|   |– Database
|   |   - config.js
|   |– Application
|   |   - config.js
|
|- public/
|   |– documentation/
|   |   |– api
|   |   |– server
|
|– src
|   |- Http
|   |   |- Middlewares
|   |   |    |-Auth
|   |   |       - AuthMiddlewares.js
|   |   |- Routes
|   |   |    |- routes.js
|   |   |- Controllers
|   |   |    |- Domain
|   |   |    |   |- Accounts
|   |   |    |   |   - AccountsController.js
|   |- Database
|   |   |- Models
|   |   |    |- Accounts
|   |   |       - AccountsModels.js
|   |   |    |
|   |- Repositories
|   |   |- Interfaces
|   |   |   - IRepository.js
|   |   |- Domain
|   |   |    |- Accounts
|   |   |    |    |- AccountsRepository.js
|   |- Providers
|   |- Library
|   |   |- Validations
|   |        |- Accounts
|   |           - ValidateDocuments.js
|   |- Helpers

Códigos de retorno HTTP da API

Código Nome Descrição
200 OK O recurso solicitado foi processado e retornado com sucesso.
201 Created O recurso informado foi criado com sucesso.
401 Unauthorized A chave da API está desativada, incorreta ou não foi informada corretamente. Consulte a seção sobre autenticação da documentação.
402 Payment Required A chave da API está correta, porém a conta foi bloqueada por inadimplência. Neste caso, acesse o painel para verificar as pendências.
403 Forbidden O acesso ao recurso não foi autorizado. Este erro por ocorrer por dois motivos: (1) Uma conexão sem criptografia foi iniciada. Neste caso utilize sempre HTTPS. (2) As configurações de perfil de acesso não permitem a ação desejada. Consulte as configurações de acesso no painel de administração.
404 Not Found O recurso solicitado ou o endpoint não foi encontrado.
406 Not Acceptable O formato enviado não é aceito. O cabeçalho Content-Type da requisição deve contar obrigatoriamente o valor application/json para requisições do tipo POST e PUT.
422 Unprocessable Entity A requisição foi recebida com sucesso, porém contém parâmetros inválidos. Para mais detalhes, verifique o atributo errors no corpo da resposta.
429 Too Many Requests O limite de requisições foi atingido. Verifique o cabeçalho Retry-After para obter o tempo de espera (em segundos) necessário para a retentativa.
400 Bad Request Não foi possível interpretar a requisição. Verifique a sintaxe das informações enviadas.
500 Internal Server Error Ocorreu uma falha na plataforma Vindi. Por favor, entre em contato com o atendimento.
Nomes e códigos seguem a RFC 2616 do IETF.

Observações: Métodos usados para buscas (GET /customers, por exemplo) retornam o código 200 mesmo que nenhum recurso tenha sido encontrado. Neste caso, o corpo da resposta conterá um array vazio. Requisições do tipo DELETE e PUT retornam o código 200 se forem processadas com sucesso.

nodejs-api-starter's People

Contributors

dorfo-dev avatar

Watchers

James Cloos avatar Luan Rodrigues avatar Lucas avatar  avatar

Forkers

luoldrigues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.