microCMS

JavaScript、iOS、AndroidのSDKを公開しました

柴田 和祈

この記事は公開後、1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

こんにちは、柴田(@shibe97)です。
JavaScript(Node.js)、iOS、Android向けのSDKを公開いたしました。
こちらのSDKを用いることで、microCMSのAPIが扱いやすくなります。

各リポジトリはこちらです。


いずれもオープンソースとなっており、どなたでもご利用いただけます。(Issue、Pull Requestも大歓迎です)
※ 現状ではGET APIのみに対応しています。

JavaScript SDK

こちらのSDKはJavaScript、またはNode.jsからご利用可能です。
npmパッケージとCDNからの配布のどちらも行なっていますので、用途に合わせてお使い分けください。

利用例:

import { createClient } from 'microcms-js-sdk';

// Initialize Client SDK.
const client = createClient({
  serviceDomain: "YOUR_DOMAIN",
  apiKey: "YOUR_API_KEY",
});

client
  .get({
    endpoint: 'endpoint',
    contentId: 'contentId',
    queries: { fields: 'title,publishedAt' },
  })
  .then((res) => console.log(res))
  .catch((err) => console.log(err));


詳しい導入方法はこちらのドキュメントをご覧ください。

iOS SDK

こちらはiOS(Swift)アプリケーション向けのSDKになります。
※ microCMSはヘッドレスCMSであるため、Webだけでなくネイティブアプリからのご利用も可能です。

本SDKは Swift Package Manager にて配布しています。

利用例:

let client = MicrocmsClient(
    serviceDomain: "YOUR_DOMAIN",
    apiKey: "YOUR_API_KEY",
)

let params: [MicrocmsParameter] = [
    .fields(["id"]),
]
client.get(
    endpoint: "API_ENDPOINT",
    contentId: "CONTENT_ID",
    params: params) { result in
    switch result {
        case .success(let object):
            print("[SUCCESS]: \(object)")
        case .failure(let error):
            print("[ERROR]: \(error)")
    }
}


詳しい導入方法はこちらのドキュメントをご覧ください。

Android SDK

こちらはAndroid(Kotlin)アプリケーション向けのSDKになります。
※ microCMSはヘッドレスCMSであるため、Webだけでなくネイティブアプリからのご利用も可能です。(大事なことなので2回言います)

本SDKは Maven Central にて配布しています。

利用例:

val client = Client(
    serviceDomain = "YOUR_DOMAIN",
    apiKey = "YOUR_API_KEY",
)

client.get(
    "API_ENDPOINT",
    "CONTENT_ID",
    listOf(Fields("id")) //some params
) { result ->
    result.onSuccess { json -> Log.d("microCMS example", json.getString("publishedAt")) }
}


詳しい導入方法はこちらのドキュメントをご覧ください。

APIプレビューにコード例を表示

今回のSDK公開に伴い、microCMS管理画面内のAPIプレビューにてSDKを利用したコード例を表示するようにしました。

選択中のエンドポイント、コンテンツID、GETパラメータに応じて動的に変わるようになっておりますので、是非ご利用ください。

おわりに

JavaScript(Node.js)、iOS、Android向けのSDKのご紹介をしました。
今後、サーバーサイド言語(PHP、Java、Goなど)向けのSDKも公開予定なのでご期待ください。

-----

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

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

APIベースの日本製ヘッドレスCMS「microCMS」を使えば、 ものの数分でAPIの作成ができます。

microCMSを無料で始める

microCMSについてお問い合わせ

初期費用無料・14日間の無料トライアル付き。ご不明な点はお気軽にお問い合わせください。

お問い合わせ

microCMS公式アカウント

microCMSは各公式アカウントで最新情報をお届けしています。
フォローよろしくお願いします。

  • X
  • Discord
  • github

ABOUT ME

柴田 和祈
microCMSのデザイン、フロントエンド担当 / ex Yahoo / 2児の父 / 著書「React入門 React・Reduxの導入からサーバサイドレンダリングによるUXの向上まで 」 / Jamstack