mirror of
https://github.com/kevin-DL/services.git
synced 2026-01-12 19:25:16 +00:00
42370d50f3
* adding descriptions * fix title * add geocoding * update location readme * update places api * update posts readme * update routing * update users
93 lines
2.4 KiB
Markdown
93 lines
2.4 KiB
Markdown
Build a blog or the foundations of a headless CMS with posts
|
|
|
|
# Post Service
|
|
|
|
Posts is the foundation of a headless CMS, storing blog posts with their metadata and enabling simple retrieval and querying.
|
|
|
|
## Create a post
|
|
|
|
### cURL
|
|
|
|
```shell
|
|
> curl 'https://api.m3o.com/posts/Save' \
|
|
-H 'micro-namespace: $yourNamespace' \
|
|
-H 'authorization: Bearer $yourToken' \
|
|
-d '{"post":{"id":"1","title":"How to Micro","content":"Simply put, Micro is awesome."}}';
|
|
|
|
> curl 'https://api.m3o.com/chat/Save' \
|
|
-H 'micro-namespace: $yourNamespace' \
|
|
-H 'authorization: Bearer $yourToken' \
|
|
-d '{"post":{"id":"2","title":"Fresh posts are fresh","content":"This post is fresher than the How to Micro one"}}';
|
|
```
|
|
|
|
### CLI
|
|
|
|
```shell
|
|
micro call posts Posts.Save '{"post":{"id":"1","title":"How to Micro","content":"Simply put, Micro is awesome."}}'
|
|
|
|
micro call posts Posts.Save '{"post":{"id":"2","title":"Fresh posts are fresh","content":"This post is fresher than the How to Micro one"}}'
|
|
```
|
|
|
|
## Create a post with tags
|
|
|
|
|
|
### cURL
|
|
|
|
```shell
|
|
> curl 'https://api.m3o.com/posts/Save' \
|
|
-H 'micro-namespace: $yourNamespace' \
|
|
-H 'authorization: Bearer $yourToken' \
|
|
-d '{"post":{"id":"3","title":"How to do epic things with Micro","content":"Everything is awesome.","tagNames":["a","b"]}}';
|
|
```
|
|
|
|
### CLI
|
|
|
|
```shell
|
|
micro call posts Posts.Save '{"post":{"id":"3","title":"How to do epic things with Micro","content":"Everything is awesome.","tagNames":["a","b"]}}'
|
|
```
|
|
|
|
## Query posts
|
|
|
|
### cURL
|
|
|
|
```shell
|
|
# Query all
|
|
> curl 'https://api.m3o.com/posts/Query' \
|
|
-H 'micro-namespace: $yourNamespace' \
|
|
-H 'authorization: Bearer $yourToken' \
|
|
-d '{}';
|
|
|
|
# Query by slug
|
|
> curl 'https://api.m3o.com/posts/Query' \
|
|
-H 'micro-namespace: $yourNamespace' \
|
|
-H 'authorization: Bearer $yourToken' \
|
|
-d '{"slug":"how-to-micro"}';
|
|
|
|
# Limit and offset
|
|
> curl 'https://api.m3o.com/posts/Query' \
|
|
-H 'micro-namespace: $yourNamespace' \
|
|
-H 'authorization: Bearer $yourToken' \
|
|
-d '{"offset": 10, "limit": 10}';
|
|
```
|
|
|
|
### CLI
|
|
|
|
```shell
|
|
micro call posts Posts.Query '{}'
|
|
micro call posts Posts.Query '{"slug":"how-to-micro"}'
|
|
micro call posts Posts.Query '{"offset": 10, "limit": 10}'
|
|
```
|
|
|
|
## Delete posts
|
|
|
|
```shell
|
|
> curl 'https://api.m3o.com/posts/Delete' \
|
|
-H 'micro-namespace: $yourNamespace' \
|
|
-H 'authorization: Bearer $yourToken' \
|
|
-d '{"id": "3c9ea66c"}';
|
|
```
|
|
|
|
```shell
|
|
micro call posts Posts.Delete '{"id": "3c9ea66c"}'
|
|
```
|