[GH-ISSUE #284] iOS share sheet and shortcuts integration/REST api help. #210

New issue

Closed

opened 2026-02-25 23:33:42 +03:00 by kerem · 2 comments

kerem commented

2026-02-25 23:33:42 +03:00

Owner

Originally created by @dazeoff on GitHub (Nov 30, 2020).
Original GitHub issue: https://github.com/go-shiori/shiori/issues/284

I'm working on an iOS Shortcut to add a share sheet button that add sites to Shiori. I'm currently able to set curl commands that login and pass the url, but I can't figure out how to pass any other info e.g. title, tags, excerpt. If you have an iOS device here is a link to the shortcut that I currently have as an example. Any guidance on what/if I'm able to use the REST api endpoints to add tags and titles when adding a url?

Originally created by @dazeoff on GitHub (Nov 30, 2020). Original GitHub issue: https://github.com/go-shiori/shiori/issues/284 I'm working on an iOS Shortcut to add a share sheet button that add sites to Shiori. I'm currently able to set curl commands that login and pass the url, but I can't figure out how to pass any other info e.g. title, tags, excerpt. If you have an iOS device here is a [link to the shortcut](https://www.icloud.com/shortcuts/6d7e38378f194dd8ae1d00efe6bf6aed) that I currently have as an example. Any guidance on what/if I'm able to use the REST api endpoints to add tags and titles when adding a url?

kerem closed this issue

2026-02-25 23:33:42 +03:00

kerem commented

2026-02-25 23:33:42 +03:00

Author

Owner

@szethh commented on GitHub (Dec 6, 2020):

Hi! I saw your issue and tried to do it. It works, kinda. For some reason shiori ignores the title and excerpt when passed with the API, so they do not work (they get fetched automatically by shiori). Tags do work (though they were a nightmare to get working, as Go does not understand JSON lists).

Here is the iCloud link. When you import it you'll have to fill in your host (http://<ip>:<port>), as well as your user and password. It logs in shiori to get a session key, then POSTs the shortcut input to the API. I also added a quick add mode to save time.

Take a look at this collection I found in #281, you can import it on Postman for more API examples.

Hope it helps! Cheers!

@szethh commented on GitHub (Dec 6, 2020): Hi! I saw your issue and tried to do it. It works, kinda. For some reason shiori ignores the title and excerpt when passed with the API, so they do not work (they get fetched automatically by shiori). Tags do work (though they were a nightmare to get working, as Go does not understand JSON lists). Here is the [iCloud link](https://www.icloud.com/shortcuts/93dce6f60fcd4b1193c44d92f003edc7). When you import it you'll have to fill in your host (`http://<ip>:<port>`), as well as your user and password. It logs in shiori to get a session key, then POSTs the shortcut input to the API. I also added a quick add mode to save time. Take a look at [this collection](https://github.com/go-shiori/shiori/blob/master/docs/postman/shiori.postman_collection.json) I found in #281, you can import it on Postman for more API examples. Hope it helps! Cheers!

kerem commented

2026-02-25 23:33:42 +03:00

Author

Owner

@szethh commented on GitHub (Dec 6, 2020):

I wrote this wiki page explaining the API a bit

@szethh commented on GitHub (Dec 6, 2020): I wrote [this wiki page](https://github.com/go-shiori/shiori/wiki/API) explaining the API a bit