{"id":15519325,"url":"https://github.com/pichillilorenzo/http-request-method-db","last_synced_at":"2026-05-04T10:41:15.324Z","repository":{"id":60393299,"uuid":"542834415","full_name":"pichillilorenzo/http-request-method-db","owner":"pichillilorenzo","description":"HTTP Request Method Database","archived":false,"fork":false,"pushed_at":"2022-09-29T15:11:05.000Z","size":74,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-03T22:41:30.806Z","etag":null,"topics":["database","db","http","http-method","http-request","http-request-method","http-request-methods","javascript","js","json","method","request","request-method"],"latest_commit_sha":null,"homepage":"https://pichillilorenzo.github.io/http-request-method-db/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pichillilorenzo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":["https://www.paypal.me/LorenzoPichilli"]}},"created_at":"2022-09-28T23:35:59.000Z","updated_at":"2023-09-08T18:38:10.000Z","dependencies_parsed_at":"2023-01-18T21:20:54.807Z","dependency_job_id":null,"html_url":"https://github.com/pichillilorenzo/http-request-method-db","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/pichillilorenzo%2Fhttp-request-method-db","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pichillilorenzo%2Fhttp-request-method-db/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pichillilorenzo%2Fhttp-request-method-db/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pichillilorenzo%2Fhttp-request-method-db/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pichillilorenzo","download_url":"https://codeload.github.com/pichillilorenzo/http-request-method-db/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246093182,"owners_count":20722402,"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":["database","db","http","http-method","http-request","http-request-method","http-request-methods","javascript","js","json","method","request","request-method"],"created_at":"2024-10-02T10:21:04.463Z","updated_at":"2026-05-04T10:41:10.299Z","avatar_url":"https://github.com/pichillilorenzo.png","language":"TypeScript","funding_links":["https://www.paypal.me/LorenzoPichilli"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# HTTP Request Method Database\n\n[![NPM](https://nodei.co/npm/http-request-method-db.png?compact=true)](https://nodei.co/npm/http-request-method-db/)\n\u003cbr /\u003e\n[![](https://img.shields.io/npm/dt/http-request-method-db.svg?style=flat-square)](https://www.npmjs.com/package/http-request-method-db)\n\n\u003c/div\u003e\n\n[![NPM Version](https://badgen.net/npm/v/http-request-method-db)](https://npmjs.org/package/http-request-method-db)\n[![license](https://img.shields.io/github/license/pichillilorenzo/http-request-method-db)](/LICENSE)\n[![Donate to this project using Paypal](https://img.shields.io/badge/paypal-donate-yellow.svg)](https://www.paypal.me/LorenzoPichilli)\n\nThis is a database of known HTTP Request Methods and information about them. It consists of a single, public JSON file and does not include any logic, allowing it to remain as un-opinionated as possible with an API. It aggregates data from the following sources:\n\n- https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods\n- https://www.iana.org/assignments/http-methods/http-methods.xhtml\n\n## Installation\n\n```bash\nnpm i --save http-request-method-db\n```\n\n### Database Download\n\nIf you want download the database and use it directly in the browser, you can just grab the\nJSON file using [jsDelivr](https://www.jsdelivr.com/). It is recommended to\nreplace `main` with [a release tag](https://github.com/pichillilorenzo/http-request-method-db/tags)\nas the JSON format may change in the future.\n\n```\nhttps://cdn.jsdelivr.net/gh/pichillilorenzo/http-request-method-db@main/dist/db.json\n```\n\n## Usage\n\n```js\nimport db from 'http-request-method-db';\n// .. or\nconst db = require('http-request-method-db').default;\n\nconst getInfo = db['get']; // An instance of HTTPRequestMethod\nconsole.log(getInfo.syntax); // GET /index.html\n```\n\nAccess HTTP Request Method info using the request method name in **lower case** as key.\n\n## Contributing\n\nThe primary way to contribute to this database is by updating the data in one of the upstream sources.\nCheck the `scripts/src/mdn-scraper.ts` to check the MDN scraper implementation.\n\n### Direct Inclusion\n\nIf that is not possible / feasible, they can be added directly here as a \"custom\" request method.\n\nTo edit the database, only make PRs against `scripts/src/custom-request-methods.json`.\n\nThe `scripts/src/custom-request-methods.json` file is a JSON object of type [HTTPRequestMethodDb](https://pichillilorenzo.github.io/http-request-method-db/interfaces/HTTPRequestMethodDb.html), where each `key` is the request method name in lower case and the `value`\nis an Object of type [HTTPRequestMethod](https://pichillilorenzo.github.io/http-request-method-db/interfaces/HTTPRequestMethod.html).\n\nTo update the build, run `npm run build:all`.\n\n## HTTPRequestMethodDb Data Structure Example\n\n```json\n{\n  \"connect\": {...},\n  \"get\": {\n    \"name\": \"GET\",\n    \"description\": \"The HTTP GET method requests a representation of the specified resource. Requests using GET should only be used to request data (they shouldn't include data). Note: Sending body/payload in a GET request may cause some existing implementations to reject the request — while not prohibited by the specification, the semantics are undefined. It is better to just avoid sending payloads in GET requests.\",\n    \"note\": \"Note: Sending body/payload in a GET request may cause some existing implementations to reject the request — while not prohibited by the specification, the semantics are undefined. It is better to just avoid sending payloads in GET requests.\",\n    \"syntax\": \"GET /index.html\",\n    \"link\": \"https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/GET\",\n    \"requestHasBody\": false,\n    \"successfulResponseHasBody\": true,\n    \"safe\": true,\n    \"idempotent\": true,\n    \"cacheable\": true,\n    \"examples\": [],\n    \"specifications\": [\n      {\n        \"name\": \"HTTP Semantics # GET\",\n        \"link\": \"https://httpwg.org/specs/rfc9110.html#GET\"\n      }\n    ],\n    \"browserCompatibility\": [\n      {\n        \"name\": \"Chrome\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Edge\",\n        \"supported\": true,\n        \"version\": \"12\"\n      },\n      {\n        \"name\": \"Firefox\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Opera\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Safari\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Chrome Android\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Firefox for Android\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Opera Android\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Safari on iOS\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Samsung Internet\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"WebView Android\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      }\n    ]\n  },\n  \"head\": {...},\n  ...\n}\n```\n\nCheck [HTTPRequestMethodDb](https://pichillilorenzo.github.io/http-request-method-db/interfaces/HTTPRequestMethodDb.html) for more details.\n\n## License\n\nReleased under the [ISC](/LICENSE) license.\n\nThis project is strongly inspired by the [mime-db](https://github.com/jshttp/mime-db).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpichillilorenzo%2Fhttp-request-method-db","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpichillilorenzo%2Fhttp-request-method-db","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpichillilorenzo%2Fhttp-request-method-db/lists"}