API機能
シンプルブログでは、記事の参照や投稿をAPI経由で行うことができます。
(※現時点でも使用していただけますが、まだ正式版ではありません。現時点ではドキュメントも本ページのみとなります。)
(※将来的に機能強化する予定)
リクエスト例
リクエスト例
投稿に成功したら、新しく作成された記事のIDを返します。
リクエスト例
(※現時点でも使用していただけますが、まだ正式版ではありません。現時点ではドキュメントも本ページのみとなります。)
■1. 記事一覧取得API
自身の記事一覧を、公開日時の降順で最新20件まで取得をします。(※将来的に機能強化する予定)
リクエスト例
curl -X GET -H "Content-Type: application/json" -H "X-API-KEY: ★★★★★" https://simblo.net/api/v0.9/post
レスポンス例
[{"id":10,"title":"テスト投稿","body":"テストです。","body_raw":"[b]テスト[/b]です。","posted_at":"2022-10-06 00:00:01","post_updated_at":null,"is_tmp":0,"created_at":"2022-10-05T18:13:10.000000Z"},{"id":9,"title":"わわわ","body":"ううう","body_raw":"[b]うう[/b]う","posted_at":"2022-10-05 00:00:01","post_updated_at":null,"is_tmp":0,"created_at":"2022-10-04T18:13:10.000000Z"},…]
■2. 記事取得API
指定した自身の記事を取得をします。リクエスト例
curl -X GET -H "Content-Type: application/json" -H "X-API-KEY: ★★★★★" https://simblo.net/api/v0.9/post/2
レスポンス例
[{"id":2,"title":"ためし","body":"ためしです。","body_raw":"[b]ためし[/b]です。","posted_at":"2022-10-02 00:00:12","post_updated_at":null,"is_tmp":0,"created_at":"2022-10-01T18:13:10.000000Z"}]
■3. 記事投稿API
記事を投稿します。投稿に成功したら、新しく作成された記事のIDを返します。
リクエスト例
curl -X POST -H "Content-Type: application/json" -H "X-API-KEY: ★★★★★" \
-d '{
"title":"これはテスト。",
"body":"[b]テスト投稿[/b]をします!!",
"posted_at":"2022-10-09 01:02:03",
"is_tmp":0,
"hashtag":null,
"is_auto_twitter_post":0,
"tw_oneline":null,
"tw_hashtag":null
}' \
https://simblo.net/api/v0.9/post
レスポンス例
-d '{
"title":"これはテスト。",
"body":"[b]テスト投稿[/b]をします!!",
"posted_at":"2022-10-09 01:02:03",
"is_tmp":0,
"hashtag":null,
"is_auto_twitter_post":0,
"tw_oneline":null,
"tw_hashtag":null
}' \
https://simblo.net/api/v0.9/post
{"id":11}