67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
# rest.js
|
||
|
||
> GitHub REST API client for JavaScript
|
||
|
||
[](https://www.npmjs.com/package/@octokit/rest)
|
||
[](https://github.com/octokit/rest.js/actions?query=workflow%3ATest+branch%3Amaster)
|
||
|
||
## Usage
|
||
|
||
<table>
|
||
<tbody valign=top align=left>
|
||
<tr><th>
|
||
Browsers
|
||
</th><td width=100%>
|
||
Load <code>@octokit/rest</code> directly from <a href="https://cdn.skypack.dev">cdn.skypack.dev</a>
|
||
|
||
```html
|
||
<script type="module">
|
||
import { Octokit } from "https://cdn.skypack.dev/@octokit/rest";
|
||
</script>
|
||
```
|
||
|
||
</td></tr>
|
||
<tr><th>
|
||
Node
|
||
</th><td>
|
||
|
||
Install with <code>npm install @octokit/rest</code>
|
||
|
||
```js
|
||
const { Octokit } = require("@octokit/rest");
|
||
// or: import { Octokit } from "@octokit/rest";
|
||
```
|
||
|
||
</td></tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
```js
|
||
const octokit = new Octokit();
|
||
|
||
// Compare: https://docs.github.com/en/rest/reference/repos/#list-organization-repositories
|
||
octokit.rest.repos
|
||
.listForOrg({
|
||
org: "octokit",
|
||
type: "public",
|
||
})
|
||
.then(({ data }) => {
|
||
// handle data
|
||
});
|
||
```
|
||
|
||
See https://octokit.github.io/rest.js for full documentation.
|
||
|
||
## Contributing
|
||
|
||
We would love you to contribute to `@octokit/rest`, pull requests are very welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for more information.
|
||
|
||
## Credits
|
||
|
||
`@octokit/rest` was originally created as [`node-github`](https://www.npmjs.com/package/github) in 2012 by Mike de Boer from Cloud9 IDE, Inc. [The original commit](https://github.blog/2020-04-09-from-48k-lines-of-code-to-10-the-story-of-githubs-javascript-sdk/) is from 2010 which predates the npm registry.
|
||
|
||
It was adopted and renamed by GitHub in 2017. Learn more about it's origin on GitHub's blog: [From 48k lines of code to 10—the story of GitHub’s JavaScript SDK](https://github.blog/2020-04-09-from-48k-lines-of-code-to-10-the-story-of-githubs-javascript-sdk/)
|
||
|
||
## LICENSE
|
||
|
||
[MIT](LICENSE)
|