change-string-case/node_modules/@octokit/plugin-rest-endpoint-methods/README.md

77 lines
2.4 KiB
Markdown
Raw Normal View History

2022-11-04 00:55:07 +08:00
# plugin-rest-endpoint-methods.js
> Octokit plugin adding one method for all of api.github.com REST API endpoints
[![@latest](https://img.shields.io/npm/v/@octokit/plugin-rest-endpoint-methods.svg)](https://www.npmjs.com/package/@octokit/plugin-rest-endpoint-methods)
[![Build Status](https://github.com/octokit/plugin-rest-endpoint-methods.js/workflows/Test/badge.svg)](https://github.com/octokit/plugin-rest-endpoint-methods.js/actions?workflow=Test)
## Usage
<table>
<tbody valign=top align=left>
<tr><th>
Browsers
</th><td width=100%>
2023-10-26 04:27:07 +08:00
Load `@octokit/plugin-rest-endpoint-methods` and [`@octokit/core`](https://github.com/octokit/core.js) (or core-compatible module) directly from [esm.sh](https://esm.sh)
2022-11-04 00:55:07 +08:00
```html
<script type="module">
2023-10-26 04:27:07 +08:00
import { Octokit } from "https://esm.sh/@octokit/core";
import { restEndpointMethods } from "https://esm.sh/@octokit/plugin-rest-endpoint-methods";
2022-11-04 00:55:07 +08:00
</script>
```
</td></tr>
<tr><th>
Node
</th><td>
Install with `npm install @octokit/core @octokit/plugin-rest-endpoint-methods`. Optionally replace `@octokit/core` with a compatible module
```js
const { Octokit } = require("@octokit/core");
const {
restEndpointMethods,
} = require("@octokit/plugin-rest-endpoint-methods");
```
</td></tr>
</tbody>
</table>
```js
const MyOctokit = Octokit.plugin(restEndpointMethods);
const octokit = new MyOctokit({ auth: "secret123" });
// https://developer.github.com/v3/users/#get-the-authenticated-user
2023-10-26 04:27:07 +08:00
octokit.rest.users.getAuthenticated();
2022-11-04 00:55:07 +08:00
```
There is one method for each REST API endpoint documented at [https://developer.github.com/v3](https://developer.github.com/v3). All endpoint methods are documented in the [docs/](docs/) folder, e.g. [docs/users/getAuthenticated.md](docs/users/getAuthenticated.md)
## TypeScript
Parameter and response types for all endpoint methods exported as `{ RestEndpointMethodTypes }`.
Example
```ts
2023-10-26 04:27:07 +08:00
import { RestEndpointMethodTypes } from "@octokit/plugin-rest-endpoint-methods";
2022-11-04 00:55:07 +08:00
2023-10-26 04:27:07 +08:00
type UpdateLabelParameters =
RestEndpointMethodTypes["issues"]["updateLabel"]["parameters"];
type UpdateLabelResponse =
RestEndpointMethodTypes["issues"]["updateLabel"]["response"];
2022-11-04 00:55:07 +08:00
```
2023-10-26 04:27:07 +08:00
In order to get types beyond parameters and responses, check out [`@octokit/openapi-types`](https://github.com/octokit/openapi-types.ts/#readme), which is a direct transpilation from GitHub's official OpenAPI specification.
2022-11-04 00:55:07 +08:00
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md)
## License
[MIT](LICENSE)