A Serverless Blog leveraging GraphQL to offer a REST API with only 1 endpoint using Serverless v0.5
A Serverless Blog leveraging GraphQL to offer a REST API with only 1 endpoint using Serverless v0.5
Please note this project uses Serverless version 0.5
#serverless-graphql-blog
This Serverless Framework Project creates a REST API for a basic blog structure, including Posts, Authors and Comments utilizing GraphQL and DynamoDB for persistent storage. What's unique about this implementation is the entire REST API consists of only 1 endpoint.
Note: This project automatically creates 3 DynamoDB tables upon serverless project install. They are defined in s-project.json.
Enjoy,
Kevin Old (Twitter)
Make sure you have the most recent version of the Serverless Framework (0.5.x and higher) and you are using NodeV4 or greater.
npm install serverless -gInstall this Serverless Project:
serverless project install serverless-graphql-blogInstall (top level) npm dependencies
npm installView project summary:
serverless dash summaryDeploy the project's Function and Endpoint:
serverless dash deployThe graphql-js endpoint provided in this Serverless Project is compatible with GraphiQL, a query visualization tool used with graphql-js.
Usage with GraphiQL.app (an Electron wrapper around GraphiQL) is recommended and is shown below:
curl -XPOST -d '{"query": "{ authors { name } }"}' /dev/blog/graphql{
"data":{
"authors":[
{"name":"Kevin"}
]
}
}curl -XPOST -d '{"query": "{ posts { id, title } }"}' /dev/blog/graphql{
"data": {
"posts": [
{ "id":"1",
"title":"First Post Title"
}
]
}
}curl -XPOST -d '{"query": "{ posts { id, title, author { name } } }"}' /dev/blog/graphql{
"data": {
"posts": [
{ "id":"1",
"title":"First Post Title",
"author":{
"name":"Kevin"
}
}
]
}
}curl -XPOST -d '{"query": "{ posts { id, title, author { id, name }, comments { id, content, author { name } } } }"}' /dev/blog/graphql{
"data":{
"posts":[
{
"id":"1",
"title":"First Post Title",
"author":{
"id":"1",
"name":"Kevin"
},
"comments":[]
}
]
}
}curl -XPOST -d '{"query": "mutation createNewPost { post: createPost (id: \"5\", title: \"Fifth post!\", bodyContent: \"Test content\", author: \"1\") { id, title } }"}' /dev/blog/graphql{
"data":{
"post":{
"id":"5",
"title":"Fifth post!"
}
}
}Validations defined using graphql-custom-types in blog/lib/schema.js
curl -XPOST -d '{"query": "mutation createNewPost { post: createPost (id: \"8\", title: \"123456789\", bodyContent: \"Test content 5\") { id, title } }"}' /dev/blog/graphql{
"errors":[
{
"message":"Query error: String not long enough"}
]
}curl -XPOST -d '{"query": "{__schema { queryType { name, fields { name, description} }}}"}' /dev/blog/graphqlReturns:
{
"data":{
"__schema":{
"queryType":{
"name":"BlogSchema",
"fields":[
{
"name":"posts",
"description":"List of posts in the blog"
},
{
"name":"authors",
"description":"List of Authors"
},
{
"name":"author",
"description":"Get Author by id"
}
]
}
}
}
}No open issues yet, or sync has not completed.