レコードの登録（POST）

些細な指摘で恐縮ですが、サンプルのJSONがフォーマットエラーのようです

Sugawara Genkiさん

cybozu.com developer network事務局です。
JSONフォーマットエラーになる箇所の修正を致しております。
ご確認ください。

サンプルのJSONでCB_IJ01が返ってくる部分がありましたので報告します。

//エラー
"ユーザー選択": {
"value":
{
"code": "sato"
}
},

//成功
"ユーザー選択": {
"value":
[
{
"code": "sato"
}
]
},

ユーザー選択の箇所は陳腐化していて、
下記のリンクが正しいようなので、ご参考ください。

■フィールド形式 – cybozu.com developer network
https://cybozudev.zendesk.com/hc/ja/articles/202166330

XMLHttpRequestを使ったPOSTの場合、プリフライトがOPTIONSで飛ぶので、そのタイミングで405が返ってきてしまいます。
回避策はありませんか？

いの　様

お世話になっております。cybozu developer network 事務局でございます。

var url = 'https://{subdomain}.cybozu.com/k/v1/records.json';

の{subdomain}をご自身の環境に合わせて書き換えられましたか？

ご確認の程宜しくお願い致します。

事務局ご担当者様
お世話になります。

以下情報です。
ご確認お願いいたします。

ターゲットアプリのURL→ https://hoge.cybozu.com/k/59/

----

function form_onsubmit()
{
var DOMAIN = "hoge.cybozu.com";
var BASE_URL = "https://" + DOMAIN + '/k/v1/record.json';
var APP_ID = 59;
var APITOKEN = "dkajfsdjfakdjkasljdfkajdkasldjkajfadklja";
var body = {
"app": APP_ID,
"record": {
"companyname": {
"value": $('#companyname').val()
},
"busho": {
"value": $('#busho').val()
},
"name": {
"value": $('#name').val()
},
"mail": {
"value": $('#mail').val()
},
"naiyo": {
"value": $('#naiyo').val()
}
}
};
var xhr = new XMLHttpRequest();
xhr.open('POST', BASE_URL);
xhr.setRequestHeader('X-Cybozu-API-Token', APITOKEN);
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');    // <-このへんは付けても付けなくても変化なし
xhr.setRequestHeader('X-HTTP-Method-Override', 'POST');        // <-このへんは付けても付けなくても変化なし
xhr.onload = function() {
if (xhr.status === 200) {
// success
console.log(JSON.parse(xhr.responseText));
} else {
// error
console.log('status: '+xhr.status);    // <-このログは吐かれません
}
};
xhr.send(JSON.stringify(body));
}

----

（コンソールのログ）
OPTIONS https://hoge.cybozu.com/k/v1/record.json 405 (JSPs only permit GET POST or HEAD)
XMLHttpRequest cannot load https://hoge.cybozu.com/k/v1/record.json. Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource. Origin 'http://myserver' is therefore not allowed access. The response had HTTP status code 405.

----

※Fiddler と Postman を使って、ローカルから同じ情報をPOSTして200が返りkintoneアプリにレコードが追加されることは確認できています。

いの　様

お世話になっております。cybozu developer network 事務局でございます。

同じソースコード（bodyだけシンプルにした）で試してみたところ、正常に登録されました。
※同じドメイン内でリクエストを投げています。

エラーからすると、サーバー側に拒否されたようです。
異なるドメイン間でリクエストしていたのでしょうか？
異なるドメインですと、kintone.proxyを使うことになります。
詳細は次のページをご参考ください。

外部APIの実行：
https://developer.cybozu.io/hc/ja/articles/202166320

コミュニティ上の同じような質問：
https://developer.cybozu.io/hc/ja/community/posts/202863444-Kintone%E3%81%AE%E7%95%B0%E3%81%AA%E3%82%8B%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E9%96%93%E3%81%A7%E3%81%AEFile%E3%81%AE%E3%83%80%E3%82%A6%E3%83%B3%E3%83%AD%E3%83%BC%E3%83%89-%E3%82%A2%E3%83%83%E3%83%97%E3%83%AD%E3%83%BC%E3%83%89

また、こちらは本記事に対するフィードバックのみ受け付けております。
直接的に記事と関連がないご質問はcybozu developer コミュニティをご活用ください。
有志達から色々アドバスを頂けると思います。

どうぞよろしくお願いいたします。

お世話になります。

おっしゃる通り、外部ドメインからの更新・登録を目的としています。
＃「kintone.proxy」って、cybozeドメインから外部ドメインへリクエストを投げる時に使うものではなかったでしたっけ？

やりたいことは以下でご紹介されていることと同じなので、node.jsからPOSTすることで当初の目的は実現できました。
https://developer.cybozu.io/hc/ja/articles/207898723-Slack%E3%81%8B%E3%82%89%E6%89%8B%E8%BB%BD%E3%81%ABkintone%E3%81%B8%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E7%99%BB%E9%8C%B2%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95

ただ、XMLHttpRequestを使った例を掲載されていたので、これでいけるかもと思った次第です。
『同じドメイン』限定なら、前提条件として示していただきたいと思いました。←これは『本記事に対するフィードバック』にならないでしょうか？
文脈から察するに、『サーバー側』にOPTIONSヘッダーを受け付けるようにしていただくのは難しそうですし、「"Access-Control-Allow-Origin" : "*"」を返していただくことも難しいのでしょうね。
やはり最初の質問の回答としては「回避策はない」ということになりますかね。

これ以上の進展が無ければ本コメントへの返信は不要です。ページを汚して申し訳ございませんでした。

いの　様

お世話になっております。cybozu developer network 事務局でございます。

外部サービスからkintoneへのPOSTですね。
ドメインの異なるサイボウズ製品だと勘違いしてしまいまして、大変失礼しました。

結論から言うと、「"Access-Control-Allow-Origin" : "*"」を返してくることはできないです。
ご期待に沿えず申し訳ございません。

ブラウザー経由ではなく、ご自身でサーバーを用意してそこにプログラムを置くか、
MS Flow等CORSを許可する他社製品を経由するなどのやり方が一般的です。

また、フィードバックいただきありがとうございました。
真摯に受け止め改善を検討いたします。

今後ともよろしくお願いいたします。

Cybozu Development team様

ichiro uozuです。初めての投稿になります。よろしくお願いします。

このページに記載してございます、ゲストスペースのエンドポイントでのレコードの登録である下記のAPIを実行しているのですが、

　　"message": "権限がありません。"

と表示され、レコードの登録が出来ません。

https://(サブドメイン名).cybozu.com/k/guest/(スペースのID)/v1/records.json 

ただし下記の通常のAPIのエンドポイントを使用するとレコードの登録が可能です。

https://(サブドメイン名).cybozu.com/k/v1/record.json

開発環境は下記になっております。

・同じTOKENを使用している

・同じアプリにレコードをPOSTしている

・everyoneに対してレコードの登録権限を付加済み

ゲストスペースのエンドポイントを使用してレコードの登録を行うには他にも何か条件が必要なのでしょうか？

ichiro uozu様

お世話になっております。cybozu developer network 事務局でございます。

ゲストスペース上のアプリに対してレコード登録を行う場合、
エンドポイントを「guest/(スペースのID)/v1/xxx.json 」とすることで実行可能です。
権限については、通常のアプリ（ゲストスペース以外にあるアプリ）に対して実行する際と同じ動作になります。
他に必要な条件はありません。

下記をご確認ください。
・レコード登録対象のアプリが、ゲストスペース上にあるか
　（アプリを開いたときのURLがhttps://subdomain.cybozu.com/k/guest/xx/xx/ となっているか）
・APIトークンを利用している場合、トークンのアクセス権で「レコード追加」が有効になっているか

また、こちらは記事のフィードバック欄です。
技術的なご質問についてはぜひコミュニティをご活用ください。

Cybozu Development team 様
お世話になります。

レコードの一括登録についての問合せです。
下記のリクエストで一括登録を試みたのですが、登録がうまくいきませんでした。
リクエストとして間違っている箇所などあれば、ご教授いただければと思います。

```
curl "https://${SUBDOMAIN}.cybozu.com/k/v1/record.json" \
    -H "X-Cybozu-Authorization: ${TOKEN}" \
    -H "Host: ${SUBDOMAIN}.cybozu.com:443" \
    -H "Content-Type: application/json" \
    -d '{"app":1,"records":[{"文字列__1行_":{"value":"AAA"},"文字列__1行__0":{"value":"aaa"},"数値":{"value":"10"},"数値_0":{"value":"20"},"ドロップダウン_0":{"value":"XK"},"ドロップダウン_1":{"value":"XKS"},"文字列__1行__1":{"value":"admin"},"ドロップダウン_2":{"value":"admin"},"数値_1":{"value":"30"},"数値_2":{"value":"40"}},{"文字列__1行_":{"value":"BBB"},"文字列__1行__0":{"value":"bbb"},"数値":{"value":"11"},"数値_0":{"value":"21"},"ドロップダウン_0":{"value":"XK"},"ドロップダウン_1":{"value":"XKS"},"文字列__1行__1":{"value":"admin"},"ドロップダウン_2":{"value":"admin"},"数値_1":{"value":"31"},"数値_2":{"value":"41"}}]}' \
    -X POST
```

上記のリクエストについて、レスポンスはステータスコード 200 が返り
`{"id":"13019","revision":"1"}` のようなレコードの登録（1件）へのレスポンスが返ってきました。

ちなみに、一括登録ではなく一件登録するリクエストは意図通りのレスポンスと登録ができています。
下記が一件登録のリクエストです。

```
curl "https://${SUBDOMAIN}.cybozu.com/k/v1/record.json" \
    -H "X-Cybozu-Authorization: ${TOKEN}" \
    -H "Host: ${SUBDOMAIN}.cybozu.com:443" \
    -H "Content-Type: application/json" \
    -d '{"app":1,"record":{"文字列__1行_":{"value":"AAA"},"文字列__1行__0":{"value":"aaa"},"数値":{"value":"10"},"数値_0":{"value":"20"},"ドロップダウン_0":{"value":"XK"},"ドロップダウン_1":{"value":"XKS"},"文字列__1行__1":{"value":"admin"},"ドロップダウン_2":{"value":"admin"},"数値_1":{"value":"30"},"数値_2":{"value":"40"}}}' \
    -X POST
```

ご確認を、よろしくお願いします。

くわやま様

お世話になっております。cybozu developer network運営事務局でございます。

一括取得のAPIのURIは、「https://(サブドメイン名).cybozu.com/k/v1/records.json」となっております。
（record ではなく record "s"）

記載いただいたコマンドでは records の "s"が抜けているようですので、

curl "https://${SUBDOMAIN}.cybozu.com/k/v1/records.json" \

としてお試しいただけますでしょうか。

確認ありがとうございます。登録できること確認できました。

お手数をおかけしました。本当にありがとうございます。

今後ともよろしくお願いいたします。

• Content-Type に application/json を指定して下さい。 指定しない場合は JSON が解釈できないため、実行時エラーとなります。

とありますが、リクエストヘッダというのは具体的にどこに記述すれば良いのでしょうか？？

チュートリアルのサンプルコードではこの記述は見受けられなかったので、ご教示頂ければ幸いです。

モツナベ 様

お世話になっております。cybozu developer network 運営でございます。

> リクエストヘッダというのは具体的にどこに記述すれば良いのでしょうか？？

JavaScript APIを経由でREST APIを利用する場合は不要です。
サーバーやモバイルなどJavaScript API以外の環境からであれば指定は必要ですが、
HeaderのContent-Typeの指定方法は通信するクライアント（使用しているプログラミング言語など）によります。

恐れ入りますが、こちらのコメント欄は記事内容のフィードバック目的となっているため、
記事から派生した技術的なご質問はcybozu developer コミュニティをご活用ください。
よろしくお願い致します。

cybozu Development team

Thanh 様

お世話になっております。cybozu developer network 運営でございます。

レコード登録、更新において、ルックアップフィールドの値を変更する場合、ルックアップフィールドの「コピー元のフィールド」はレコード番号または「値の重複を禁止する(unique=true)」に設定されている必要があります。

その他 API を利用する際の制限については、制限事項 をご確認ください。

恐れ入りますが、こちらのコメント欄は記事内容のフィードバック目的となっているため、
記事から派生した技術的なご質問はcybozu developer コミュニティをご活用ください。
よろしくお願い致します。

ご質問させていただきたいです。

このAPIは、複数のアプリを一括して処理できますか。

自動で、複数アプリのデータを1つアプリにコピーしたいですから。

よろしくお願いいたします。

chu thi hue 様
お世話になっております。cybozu developer network 運営局です。

>このAPIは、複数のアプリを一括して処理できますか。

複数のレコードを一括登録する場合は、こちらのAPIで対応できます。
詳細は本記事の「レコードの一括登録」部分をご参照ください。
また、複数アプリへのレコード一括処理の場合は、こちらの記事をご参照ください。

恐れ入りますが、こちらのコメント欄は記事内容のフィードバック目的となっているため、
記事から派生した技術的なご質問はcybozu developer コミュニティをご活用ください。
よろしくお願い致します。

お世話になっております。
フィールド形式が文字列型で「値の重複を禁止する」がONになっている場合に「999」と「999_」(_は半角スペース)が相互で重複エラーになり同時に登録することができないようです。

この動作はAPIに関わらずフォームやCSVで登録した場合でも同様です。

ご確認の程、よろしくお願いいたします。

yohmi 様
お世話になっております。cybozu developer network 運営局です。

動作確認を行ったところ、yohmi 様と同様の動きを再現することができました。ご共有いただいた挙動を担当部署に申し伝え、仕様の改善を検討していきます。

引き続き、どうぞよろしくお願いいたします。