{"id":21717260,"url":"https://github.com/jormaechea/aws-http-api-gateway","last_synced_at":"2025-08-08T18:55:39.400Z","repository":{"id":43978747,"uuid":"245940792","full_name":"jormaechea/aws-http-api-gateway","owner":"jormaechea","description":"A framework to implement AWS HTTP APIs with ease","archived":false,"fork":false,"pushed_at":"2023-01-05T09:41:21.000Z","size":235,"stargazers_count":0,"open_issues_count":8,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-26T03:08:28.510Z","etag":null,"topics":["api","api-framework","api-gateway","api-gateway-v2","aws","framework","http-api","serverless"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jormaechea.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-03-09T04:04:45.000Z","updated_at":"2020-04-06T02:49:08.000Z","dependencies_parsed_at":"2023-02-03T23:16:40.302Z","dependency_job_id":null,"html_url":"https://github.com/jormaechea/aws-http-api-gateway","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jormaechea%2Faws-http-api-gateway","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jormaechea%2Faws-http-api-gateway/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jormaechea%2Faws-http-api-gateway/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jormaechea%2Faws-http-api-gateway/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jormaechea","download_url":"https://codeload.github.com/jormaechea/aws-http-api-gateway/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244682222,"owners_count":20492930,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-framework","api-gateway","api-gateway-v2","aws","framework","http-api","serverless"],"created_at":"2024-11-26T01:15:50.437Z","updated_at":"2025-03-20T20:10:28.487Z","avatar_url":"https://github.com/jormaechea.png","language":"JavaScript","readme":"# AWS HTTP API Gateway Framework\n\n[![npm version](https://badgen.net/npm/v/aws-http-api-gateway)](https://www.npmjs.com/package/aws-http-api-gateway)\n[![Build Status](https://travis-ci.org/jormaechea/aws-http-api-gateway.svg?branch=master)](https://travis-ci.org/jormaechea/aws-http-api-gateway)\n[![Coverage Status](https://coveralls.io/repos/github/jormaechea/aws-http-api-gateway/badge.svg?branch=master)](https://coveralls.io/github/jormaechea/aws-http-api-gateway?branch=master)\n\n**AWS API Gateway - HTTP API Framework** -- _Also called API Gateway v2_.\n\nA framework to easily implement HTTP APIs in AWS API Gateway. Implement CRUD operations in less than 100 lines of code!\n\nTest a working [demo](https://github.com/jormaechea/aws-http-api-gateway-demo) for your own with this repo.\n\n# Docs\n\nThe framework complete docs can be found [here](docs/README.md).\n\n## Quick start\n\n1. Install via npm\n\n```bash\nnpm i aws-http-api-gateway\n```\n\n2. Setup your serverless function\n\n```yml\n# serverless.yml\nservice:\n  name: PetStore\nprovider:\n  name: aws\n  runtime: nodejs12.x\nfunctions:\n  PetsGetManyApi:\n    handler: src/apis/pets/get-many.handler\n    events:\n      - httpApi: 'GET /pets'\n```\n\n3. Code your handler\n\n```js\n// src/apis/pets/get-many.js\n'use strict';\n\nconst { GetManyApi, ApiHandler } = require('aws-http-api-gateway');\n\nconst PetConnector = require('../../connectors/pets');\n\nconst petConnector = new PetConnector();\n\nclass PetGetManyApi extends GetManyApi {\n\n\tget dataConnector() {\n\t\treturn petConnector;\n\t}\n\n};\n\nmodule.exports.handler = ApiHandler(PetGetManyApi);\n\n```\n\n4. Code your data connector (implement with your favorite database)\n\n```js\n'use strict';\n\nconst dbHandler = require('some-db-handler');\n\nmodule.exports = class PetsConnector {\n\n\tget(getParams) {\n\t\treturn dbHandler.get(getParams);\n\t}\n\n};\n```\n\n5. You're ready to go. Just deploy your service!\n\n```bash\nserverless deploy\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjormaechea%2Faws-http-api-gateway","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjormaechea%2Faws-http-api-gateway","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjormaechea%2Faws-http-api-gateway/lists"}