microCMSブログ

microCMSの最新情報や活用事例などをお届けします。

更新情報

idを指定して複数のコンテンツを 一度に取得できるようになりました

idを指定して複数のコンテンツを 一度に取得できるようになりました
松田 承一 松田 承一

こんにちは、ウォンタ株式会社代表取締役の松田です。
本日の更新情報をお知らせします!
今回はコンテンツAPIに関する内容です。

idsパラメータが導入されました

今回新たにidsというパラメータが新たに導入され、コンテンツAPIの利用時にコンテンツのidを指定することで複数のコンテンツを取得できるようになりました。

使い方はとてもシンプルです。
リクエストURLにidsというパラメータを付与してください。
idsには ids=first_id,second_id のようにカンマ区切りで複数のidを指定できます。

ご利用例

curl "https://example.microcms.io/api/v1/news?ids=29yR6p-t9,1rvXHlNIo" -H "X-MICROCMS-API-KEY: dc59f358-4622-471f-8d1e-6c7a6f969558"


なお、この方法で一度に取得できるコンテンツは最大で100件までであることや、filtersqといったいくつかのパラメータとの併用はできない点にご注意ください。
詳しくはAPIドキュメントもご覧ください。

終わりに

今回のパラメータの導入により、例えば外部のシステムで算出したidの一覧からコンテンツを取得する場合にスムーズな対応が可能になります。
ぜひみなさまご活用ください!

-----

microCMSは日々改善を進めています。
ご意見・ご要望は管理画面右下のチャット、公式Twitterメールからお気軽にご連絡ください!
引き続きmicroCMSをよろしくお願いいたします!

まずは、無料で
試してみましょう。

microCMSは無料ではじめられます。
ご不明な点はお気軽にお問い合わせください。