This is a GraphQL API for the Rate Repository application implemented in Full Stack Open course's React Native part.
Tested with Node version 16, but later versions might work as well) and npm. If you haven't installed Node or npm, nvm is an easy to use tool for installing both. Nvm is also handy if you want to quickly switch between different Node versions.
-
Clone this repository and run
npm install
in therate-repository-api
directory. -
Rate Repository API uses the GitHub API, which has a quite small rate limit (60 requests per hour) for unauthorized requests. Therefore, we need to register it as an OAuth application to obtain client credentials. Register your OAuth application here by setting "Application name" as "Rate Repository API", "Homepage URL" as https://github.com/Kaltsoon/rate-repository-api and "Authorization callback URL" as http://localhost:5000. Now you should see your application here and by going to the application's page, see the "Client ID" and "Client Secret" values.
-
Create a file
.env
in therate-repository-api
directory and copy the contents of the.env.template
file there. In the.env
file, replaceGITHUB_CLIENT_ID
, andGITHUB_CLIENT_SECRET
variable values with your newly registered OAuth application's credentials. If you want, you can also use a different secret for theJWT_SECRET
variable, which is used to sign access tokens. -
Run
npm run build
. This will setup the SQLite database and run the migrations. -
To populate the database with some seed data, run
npm run seed:run
. Note: running this command will remove all existing data. -
All done! Just run
npm start
to start the server. After the server has started you should be able to access the Apollo Sandbox at http://localhost:4000.
To list all the registered users, you can run this query in the Apollo Sandbox:
{
users {
edges {
node {
username
}
}
}
}
You can retrieve an access token by performing the authenticate
mutation:
mutation {
authenticate(credentials: { username: "kalle", password: "password" }) {
accessToken
}
}
All access tokens expire after seven days. If you performed step 5. in the "Getting started" section, users "kalle", "elina" and "matti" all have the password "password".
You can also register a new user by performing the createUser
mutation:
mutation {
createUser(user: { username: "myusername", password: "mypassword" }) {
id
username
}
}
A handy way to authorize requests in the Apollo Sandbox is to retrieve an access token using the authorize
mutation (see above for details) and then add the following in the "Headers" tab below the operations editor:
{
"Authorization": "Bearer <ACCESS_TOKEN>"
}
Replace the <ACCESS_TOKEN>
part with your access token.
Apollo Sandbox offers documentation on how to use the API. Start the server by running npm start
, open the Apollo Sandbox at http://localhost:4000 and you should be able to see the documentation next to the operations editor.
Submit an issue with the bug description and a sway to reproduce the bug. If you have already come up with a solution, we will gladly accept a pull request.
-
How to reset the database? If you are absolutely sure that you want to remove all the existing data, just remove the
database.sqlite
file in therate-repository-api
directory and runnpm run build
. You can runnpm run seed:run
to initialize the new database with seed data. -
Is this production ready? Almost. The current version of the API utilizes the SQLite database, which is not quite suitable for production. Luckily, all database queries are performed with Objection ORM, and changing the underlying database driver is just a matter of configuration.