如何使用 Flutter 在 Airtable 中读写数据？

Question

依赖项：airtable: ^0.0.2 import 'package:airtable/airtable.dart'; ??

导入'包：dart_airtable/dart_airtable.dart'； ??

void main() async {
  final apiKey = 'my-airtable-api-key'
  final projectBase = 'my-airtable-project-base';
  final recordName = 'Tasks';

  var airtable = Airtable(apiKey: apiKey, projectBase: projectBase);
  var records = await airtable.getAllRecords(recordName);

  print(records);
}

如果有人知道如何解决它，我将不胜感激。

Answer 1

首先，您似乎将两件事混合在一起。 目前有两个packages提供了与 airtable 通信的库： airtable 0.0.2和dart_airtable 0.1.1 。

在您的示例代码中，您使用第一个package的 import 语句，但使用第二个package的代码。 由于第一个没有提供到repository的有效链接，我将看看第二个。

要从 API 检索项目的records ，您可以使用以下代码：

var records = await airtable.getAllRecords(recordName);

不幸的是，该package有一些错误。 因为我想创建一个记录，所以我使用了createRecord方法，如下所示：

var test = await airtable.createRecord(
  recordName,
  AirtableRecord(
    fields: [
      AirtableRecordField(
        fieldName: 'Short Description',
        value: 'Test Description',
      ),
    ],
  ),
);

print(test);

但我得到的唯一response是null 。 所以我克隆了项目并调试了方法。 结果是这样的：

{"error":{"type":"INVALID_REQUEST_UNKNOWN","message":"Invalid request: parameter validation failed. Check your request data."}}

经过一番搜索，我发现该package向 airtable API 发送了错误的数据。 在AirtableRecord模型的一个toJson方法中，作者添加了不必要的字段id和createdTime 。 删除它们后，该方法有效。

回复：

AirtableRecord(id: rec9bqN78Le1dbC1g, createdTime: 2020-10-20 19:10:21.000Z, fields: {Short Description: Test Description})

我没有寻找剩余的方法，但我的建议是编写自己的与 airtime API 的连接或使用现有package并更改不起作用的东西。 希望这对你有帮助。

编辑：

我再去查一下repository ，貌似作者不活跃。 由于它只包含一些与 airtable API 一起使用的方法和模型，我猜想自己编写实现并不是一个坏主意。

这是一个如何执行此操作的简单示例（使用Dio进行网络连接）：

try {
  final response = await Dio().post(
    'https://api.airtable.com/v0/$projectBase/$recordName',
    options: Options(
      contentType: 'Application/json',
      headers: {
        'Authorization': 'Bearer $yourApiKey',
        'Accept': 'Application/json',
      },
    ),
    data: {
      'records': [
        {
          'fields': {
            'Short Description': 'Cactus',
            'Total': 11.5,
          }
        },
      ],
    },
  );

  // TODO: Whatever you want to do with the response. A good practice is to transform it into models and than work with them
  print(response);
} on DioError catch (e) {
  // TODO: Error handling
  if (e.response != null) {
    print(e.response.data);
  } else {
    print(e.request);
    print(e.message);
  }
}

回复：

{"records":[{"id":"recrvxH93gJgAGo7j","fields":{"Short Description":"Cactus","Total":11.5},"createdTime":"2020-10-21T20:41:19.000Z"}]}

你现在可以扩展它，也许作为一个带有GetIt包的service并添加你需要的功能。 我明确建议您也使用models来response （看看这个）。

我使用了他们的示例工作区之一。 projectBase 是一个 ID。 您可以查看他们的 API 文档以了解如何构建requests 。

编辑2：

阅读可以通过以下方式简单地完成：

final response = await Dio().get(
    'https://api.airtable.com/v0/$projectBase/$recordName',
    options: Options(
      contentType: 'Application/json',
      headers: {
        'Authorization': 'Bearer $yourApiKey',
        'Accept': 'Application/json',
      },
    ),
  );

更新：

final response = await Dio().patch(
    'https://api.airtable.com/v0/$projectBase/$recordName',
    options: Options(
      contentType: 'Application/json',
      headers: {
        'Authorization': 'Bearer $yourApiKey',
        'Accept': 'Application/json',
      },
    ),
    data: {
      'records': [
        {
          'id': 'rechYkD0pDW1NjFAF',
          'fields': {
            'Short Description': 'Cactus II',
            'Total': 11.5,
          }
        },
      ],
    },
  );

并删除：

final response = await Dio().delete(
    'https://api.airtable.com/v0/$projectBase/$recordName/rec0bMv507juqS7pv',
    options: Options(
      headers: {
        'Authorization': 'Bearer $yourApiKey',
        'Accept': 'Application/json',
      },
    ),
  );

这些只是示例，我建议您也阅读 API 文档以了解可能的内容。 以及您自己的正确错误处理的实现。

编辑3：

您可以使用filterByFormula参数来检索与您的条件匹配的所有数据 ( Reference )。

例如：

final response = await Dio().get(
    'https://api.airtable.com/v0/$projectBase/$recordName',
    queryParameters: {
      'filterByFormula': 'SEARCH("Cactus",{Short Description})' // Searches the value 'Cactus' in the 'Short description' field.
    },
    options: Options(
      headers: {
        'Authorization': 'Bearer $yourApiKey',
        'Accept': 'Application/json',
      },
    ),
  );