テーブルデータの追加

このAPIでは、1回の操作で最大1,000行までのデータを、指定したエージェントのデータテーブルに追加できます。追加されたデータは会話や検索に活用されます。

注意:

unique（一意）が有効なフィールドの値の長さは、256文字を超えることはできません。

unique（一意）が無効なフィールドの値の長さは、4294967295文字を超えることはできません（実際にはネットワークの制限により、データ長を適切に制御することを推奨します）。

インターフェースを通じて転送されたデータはCSVデータに変換され、CSVファイルのサイズは10MBを超えることはできません。

リクエストメソッド

POST

エンドポイント

https://api-${endpoint}.gptbots.ai/v1/database/import/records

認証

認証方法の説明についてはAPI Overviewをご参照ください。

リクエスト

リクエスト例

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/import/records' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "table_id": "673af861ed69656ac0895b07", "records": [ { "values": { "id": "7424489", "name": "4455566777777" } }, { "values": { "id": "7852549", "name": "446656677665" } } ] }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/import/records' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
    "table_id": "673af861ed69656ac0895b07",
    "records": [
        {
            "values": {
                "id": "7424489",
                "name": "4455566777777"
            }
        },
        
        {
            "values": {
                "id": "7852549",
                "name": "446656677665"
            }
        }
    ]
}'

このコードブロックをポップアップで表示

リクエストヘッダー

フィールド	タイプ	説明
Authorization	Bearer ${API Key}	認証には `Authorization: Bearer ${API Key}` を使用してください。トークンはAPIキーページから取得できます。
Content-Type	application/json	データの形式は `application/json` を設定してください。

リクエストボディ

フィールド	タイプ	必須	説明
records	List	必須	インポートするデータの集合です。
table_id	String	必須	対象となるテーブルのIDです。

レスポンス

レスポンス例

{ "code": 0, "message": "success", "data": [ "673e9cda9f7bc178002dbd9c" ] }

                      
                      {
    "code": 0,
    "message": "success",
    "data": [
        "673e9cda9f7bc178002dbd9c"
    ]
}

このコードブロックをポップアップで表示

成功時のレスポンス

フィールド	タイプ	説明
code	Int	メッセージ種別コード
message	String	メッセージの説明
data	Array	このテーブルデータ追加操作のタスクID（1つのIDのみが返されます）

エラー時のレスポンス

フィールド	タイプ	説明
code	Int	エラーコード
message	String	エラー詳細内容

エラーコード

コード	メッセージ
40000	パラメータが無効です
50000	システム内部エラー