https://github.com/autom8-apps/strapi--javascript-sdk
https://github.com/autom8-apps/strapi--javascript-sdk
strapi
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/autom8-apps/strapi--javascript-sdk
- Owner: autom8-apps
- License: mit
- Created: 2020-09-18T15:55:05.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-10-14T23:51:43.000Z (over 3 years ago)
- Last Synced: 2025-02-06T06:08:09.246Z (4 months ago)
- Topics: strapi
- Language: TypeScript
- Homepage:
- Size: 320 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
### DESCRIPTION
This is a duplicated version of the no longer maintained **[strapi javascript sdk](https://github.com/strapi/strapi-sdk-javascript)**
**USE WITH CAUTION:** I revamped the no longer supported project because I didn't want to build my own SDK and I wanted something I could use for my various personal projects. I have no intention at the moment of supporting this package for the long term. Install at your own discretion.
---
## Install
```sh
npm install @autom8apps/strapi-sdk-javascript
```
## Start now
### New instance
```js
import Strapi from '@autom8apps/strapi-sdk-javascript';
const strapi = new Strapi('http://localhost:1337');
```
### Authentications
#### Local
```js
await strapi.login('username_or_email', 's3cr3t');
```
#### [Providers](https://strapi.io/documentation/guides/authentication.html#providers)
```js
// Redirect your user to the provider's authentication page.
window.location = strapi.getProviderAuthenticationUrl('facebook');
```
Once authorized, the provider will redirects the user to your app with an access token in the URL.
```js
// Complete the authentication: (The SDK will store the access token for you)
await strapi.authenticateProvider('facebook');
```
You can now fetch private APIs
```js
const posts = await strapi.getEntries('posts');
```
### Files management
#### Browser
```js
const form = new FormData();
form.append('files', fileInputElement.files[0], 'file-name.ext');
form.append('files', fileInputElement.files[1], 'file-2-name.ext');
const files = await strapi.upload(form);
```
#### Node.js
```js
const FormData = require('form-data');
const fs = require('fs');
const form = new FormData();
form.append('files', fs.createReadStream('./file-name.ext'), 'file-name.ext');
const files = await strapi.upload(form, {
headers: form.getHeaders()
});
```
## Functions/Methods
### `Strapi(baseURL, storeConfig, requestConfig)`
### `request(method, url, requestConfig)`
### `register(username, email, password)`
### `login(identifier, password)`
### `forgotPassword(email, url)`
### `resetPassword(code, password, passwordConfirmation)`
### `getProviderAuthenticationUrl(provider)`
### `authenticateProvider(provider, params)`
### `setToken(token, comesFromStorage)`
### `clearToken(token)`
### `getEntries(contentTypePluralized, params)`
### `getEntry(contentTypePluralized, id)`
### `getEntryCount(contentTypePluralized, params)`
### `createEntry(contentTypePluralized, data)`
### `updateEntry(contentTypePluralized, id, data)`
### `deleteEntry(contentTypePluralized, id)`
### `searchFiles(query)`
### `getFiles(params)`
### `getFile(id)`
### `upload(data)`
#### requestConfig
Custom axios request configuration. [See documentation](https://github.com/axios/axios#request-config)
## Resources
* [Documentation](https://strapi.github.io/strapi-sdk-javascript)
* [Changelog](https://github.com/strapi/strapi-sdk-javascript/blob/master/CHANGELOG.md)
* [Medium story](https://medium.com/strapi/announcing-the-strapi-javascript-sdk-ac89f140a9d1)
## Credits
* [axios](https://github.com/axios/axios)
* [typescript-starter](https://github.com/bitjson/typescript-starter)
* [The talented Strapi team, thank you so much for building this!](https://strapi.io/)
## License
MIT