README

基本的 SDK，用于处理 Airtable 记录。

安装

通过运行以下命令告诉 composer 需要此捆绑包：

composer require ryanh7g/airtable-php

使用方法

$key   = "APP_KEY"; // Generated from : https://airtable.com/account
$base  = "BASE_ID"; // Find it on : https://airtable.com/api
$table = "TABLE_NAME"; // Find it on : https://airtable.com/api

$airtable = new Airtable($key, $base);

$records = $airtable->findRecords($table);

可用方法

• Airtable::createTableManipulator(string $table): TableManipulator
• Airtable::getRecord(string $table, string $id)
• Airtable::createRecord(string $table, array $fields)
• Airtable::setRecord(string $table, array $criteria = [], array $fields)
• Airtable::updateRecord(string $table, array $criteria = [], array $fields)
• Airtable::containsRecord(string $table, array $criteria = [])
• Airtable::flushRecords(string $table)
• Airtable::deleteRecord(string $table, array $criteria = [])
• Airtable::findRecord(string $table, array $criteria = [])
• Airtable::findRecords(string $table, array $criteria = [], string $view = null)

示例

一个简单的成员索引器，封装了 Airtable 的简单 API。可用于在 Airtable 上启动 CRM。

注意：由于 Airtable 不允许通过其公共 API 进行架构操作，您应使用以下 WebUI 配置表：

• Id : 文本
• Firstname : 文本
• Lastname : 文本
• Email : 电子邮件
• CreatedAt : 日期和时间
• Picture : 附件

$key   = "APP_KEY"; // Generated from : https://airtable.com/account
$base  = "BASE_ID"; // Find it on : https://airtable.com/api
$table = "TABLE_NAME"; // Find it on : https://airtable.com/api

$airtable = new Airtable($key, $base);

$records = $airtable->findRecords($table);

use Armetiz\AirtableSDK\Airtable as AirtableClient;

class MemberIndex
{
    private $airtable;

    public function __construct(AirtableClient $airtableClient, string $table)
    {
        $this->airtable = $airtableClient->createTableManipulator($table);
    }

    public function clear()
    {
        $this->airtable->flushRecords();
    }

    public function save(array $data)
    {
        $criteria = ["Id" => $data["id"]];
        $fields   = [
            "Id"                    => $data["id"],
            "Firstname"             => $data["firstName"],
            "Lastname"              => $data["lastName"],
            "Email"                 => $data["email"],
            "CreatedAt"             => (string)$data["createdAt"],
        ];

        if ($this->airtable->containsRecord($criteria)) {
            $this->airtable->updateRecord($criteria, $fields);
        } else {
            $this->airtable->createRecord($fields);
        }
    }

    public function delete($id)
    {
        $this->airtable->deleteRecord(["Id" => $id]);
    }
}

测试

尚未实现。

许可证

此库受 MIT 许可证的约束。 查看完整许可证。

致谢

原作者 - Thomas Tourlourat