kintone café 福岡 vol6 第1部 7月 API情報

kintone API
7月アップデート情報
2015/8/29
サイボウズ株式会社
竹内能彦

kintone Café 福岡 Vol.6
自己紹介
名前：竹内能彦（たけうちよしひこ）
年齢： 32歳
出身：香川県坂出市
経歴： 2014年サイボウズ株式会社中途入社
所属：システムコンサルティング本部関西SCグループ（新大阪勤務）

サイボウズの製品

Garoon と Googleカレンダー連携
• GaroonのスケジュールをGoogleカレンダーに反映

Garoon と Googleカレンダー連携の公開場所

拡大

developer networkのコミュニケーション

目次
• kintone API 7月のアップデート情報
• ステータス更新API + デモ
• デプロイAPI + デモ

kintone API 7月のアップデート情報

JavaScript API
• Promise対応
kintoneのリクエスト系APIは全て非同期
=> 同期リクエストが必要な場合はXMLHttpRequestを利用
=> XMLHttpRequestを使わなくて良くなる
• テーブルの行追加・削除ボタンクリック時のイベント取得
• 分かりにくいエラーメッセージを修正
• 不具合改修

JavaScript API
• Promise対応
kintoneのリクエスト系APIは全て非同期
=> 同期リクエストが必要な場合はXMLHttpRequestを利用
=> XMLHttpRequestを使わなくて良くなる
• テーブルの行追加・削除ボタンクリック時のイベント取得
• 不具合改修
地味な改修に見えてかなり有り難い
ドツボにはまるということが少なくなりそう・・・

REST API
• レコードのステータスを更新するAPI
• アプリをデプロイするAPI
• 日付のフォーマット仕様変更
• リクエストヘッダーにX-HTTP-Method-Overrideを指定
• 不具合改修

REST API
• 不具合改修
今回はこの2つのAPIについて詳しく説明

REST API
• 不具合改修
月日を省略した場合は01で補完されます。
* 2015 -> 2015-01-01
* 2015-07 -> 2015-07-01
* 2015-7 -> 2015-07-01
* 2015-7-5 -> 2015-07-05

kintone Café 福岡 Vol.6・リクエストヘッダー
GET /k/v1/records.json?app=oo&query=ほげほげ・・・
・リクエストヘッダー
POST /k/v1/records.json
X-HTTP-Method-Override: GET
・リクエストボディ
{
"app": "oo",
“query”: “ほげほげ・・・"
}
REST API
• 不具合改修

kintoneのプロセス管理
• 複数のユーザーでレコードの編集や確認をするためのプロセス（ワークフロー）を設定できます。
• 各レコードのステータス（処理状況）が表示されるようになります。

例）ステータスの更新
• リクエスト
curl
-X PUT
-H “X-Cybozu-Authorization: XXXX"
-H “Authorization: XXXX”
-H "Content-Type: application/json"
-d ‘{“app”:OO, “id”:□□, “action”:“△△"}'
"https://xxxxxxxx.cybozu.com/k/v1/record/status.json" | jq
• レスポンス

例）ステータスの更新
• リクエスト
curl
-X PUT
-H "Content-Type: application/json"
-d ‘{“app”:OO, “id”:□□, “action”:“△△"}'
"https://xxxxxxxx.cybozu.com/k/v1/record/status.json" | jq
• レスポンス
actionにはアクション名を指定

アクション名とは・・・
• 詳細画面
• 設定画面

ステータス更新APIの注意事項
例えば・・・
バッチ処理で特定期間経過後に
一括承認/却下したい場合
API TOKENでは実行できない
• ユーザー認証でAPIを実行する場合、次の2つの条件にあてはまるレコードでAPIを実行できます。
• APIの実行ユーザーがレコードの閲覧権限を持つ
• レコードに作業者が指定されていない、または、APIの実行ユーザーがレコードの作業者に指定されている
• APIトークンでAPIを実行する場合、次の2つの条件にあてはまる場合にAPIを実行できます。
• レコードの閲覧を許可したAPIトークンを使用する
• レコードに作業者が指定されていない、または、「Administrator」がレコードの作業者に指定されている

デモ①
- ステータスの一括更新 -

新規追加、機能追加されたREST API
• アプリの作成と設定変更
• アプリ設定の運用環境への反映
• アプリの設定情報の取得/変更
• 一般設定
• フォーム設定
• 一覧設定
• アクセス権設定（アプリ、レコード、フィールド）
• JavaScript / CSSカスタマイズ設定

例）アプリの一般設定の取得
• リクエスト
curl
-X GET
"https://xxxxxxxx.cybozu.com/k/v1/app/settings.json?app=OO" | jq
• レスポンス
API TOKENは使えない
アプリの説明にはHTMLタグも含まれる

例）アプリのフォーム設定の取得
• リクエスト
curl
-X GET
-H "X-Cybozu-Authorization: XXXX"
-H "Authorization: XXXX”
"https://xxxxxxxx.cybozu.com/k/v1/app/form/fields.json?app=OO" | jq
API TOKENは使えない

例）日付フィールドの設定取得
• フィールドの設定 • レスポンス

例）ラジオボタンフィールドの設定取得
• フィールドの設定 • レスポンス

kintoneはファストシステム
• すぐ作れる
• すぐ使える
• 変更も簡単

案件での対応は・・・
• 要件を確認
• 仕様を考えて
• アプリを作って
• 使ってみて
• 修正して

案件での対応は・・・
• 要件を確認
• 仕様を考えて
• アプリを作って
• 使ってみて
• 修正して
とっても順調！
楽しい！

ですが・・・
• 検収には仕様書が必要な場合も・・・
面倒

ですが・・・
• 検収には仕様書が必要な場合も・・・
アプリから仕様書
が作れないかなー

デモ②
- アプリ設計情報をPDFに -

帳票サービス
・プリントクリエイター
・SVF Cloud for kintone
・OPROARTS Connector for kintone
・ReportsConnect for kintone
・kintone 楽々帳票
・Excel – kintone 連携

連携サービスのTips

まとめ
• 7月のアップデートでは開発者にとって嬉しい機能が多数追加
• kintoneではアプリの仕様書まで自身で作成
• 是非皆さんも使ってみてください

kintone café 福岡 vol6 第1部 7月 API情報

Recommended

Recommended

More Related Content

Similar to kintone café 福岡 vol6 第1部 7月 API情報

Similar to kintone café 福岡 vol6 第1部 7月 API情報 (12)

kintone café 福岡 vol6 第1部 7月 API情報

Editor's Notes