Acuity Scheduling：嵌入和开发人员集成

Acuity Scheduling 的开发人员解决方案

今天，我将向您介绍 Acuity Scheduling的嵌入式预订开发平台，以及用于定制集成的 api。如果您还没有看过它，我鼓励您阅读我们 从第一集开始对Acuity Scheduling 日历预订和预约服务的基本介绍。

嵌入提供了一种轻量级的方式来向任何网站添加日程安排和预约。使用 Acuity 的约会计划 API，您可以将其所有复杂的日历功能集成到您自己的网站、服务或移动应用程序中。

Acuity Scheduling 以成为对开发人员最友好的调度解决方案而自豪。但它也是一个非常有效的网络服务，可以满足您所有的日程安排、预订和日历预约的需求。 

如果您想了解有关其面向消费者的调度功能的更多信息，请观看 下面的调度视频 ：

由于这里的空间有限，我鼓励您 在 Acuity 注册 并自行探索更多内容。但是现在，让我们深入了解 Acuity 的开发者门户。

在我开始之前，我想鼓励您提出有关 Acuity Scheduling 和我们的教程系列的任何问题。请在下面的评论中发布它们，或者随时在 Twitter 上与我联系@lookahead_io 。

嵌入 Acuity 的日历预订

您无需成为程序员或使用Acuity的 API 即可将其日程安排和日历预订功能集成到您的网站中。有几种简单的方法。

链接到 Acuity 的调度功能

从您的网站或应用程序链接到 Acuity 的网站非常简单。这会将客户带到您在 Acuity 网站上配置的日程安排界面。这是第一集中的一个例子：

Acuity 的开发人员嵌入文档还提供了将常用字段从您的应用程序传递到 Acuity 调度程序的说明，从而节省您的用户时间。

这是从您的网站向 Acuity 传递值的示例 URL：

https://example.acuityscheduling.com/schedule.php?

firstName=First&lastName=Last&phone=Phone&email=email@example.com

您可以发送各种字段：

如果您在 Acuity 设置了自定义摄入表单字段，您还可以通过链接传输这些字段：

https://example.acuityscheduling.com/schedule.php?
field:1=Wonderful

他们甚至支持发送下拉字段和复选框的预配置。

在您的网站中嵌入调度程序

您还可以将iframe Acuity 帐户中的一个放入您自己的网站。

我帐户的代码如下所示：

<iframe src="https://app.acuityscheduling.com/schedule.php?owner=132xxxx" 
width="100%" height="800" frameBorder="0">
</iframe><script src="https://d3gxy7nm8y4yjr.cloudfront.net/js/embed.js" type="text/ javascript ">
</script>

他们为常见平台提供指南： 

• Facebook

• wordpress

• 广场空间

• 去吧爸爸

• 蹑手蹑脚

• 德鲁巴

• joomla

• 网站

• 蜡

• Zenfolio

如果您要求，他们的开发人员还将为您进行嵌入。他们为此提供了一个简单的 Web 表单（它确实需要您共享您的登录信息，当然您可以在集成后更改）：

嵌入应用程序

您还可以轻松地将 Acuity 的调度程序嵌入 ios 和 android 应用程序中。Acuity 的html嵌入代码也可用于使用 ios 上的WKwebview或 android 上的WebView将调度程序嵌入到本机应用程序中。 

Acuity为 iOS 和 Android 嵌入提供了 GitHub 托管的 示例代码。基本上，您只需下载存储库并使用 Xcode 打开 iOS webview Acuity，或使用 Android Studio 打开 AndroidWebviewAcuity。

现在，让我们谈谈 Acuity 对开发人员友好的调度和预订 API。

Acuity 调度开发人员 API

我们已经介绍了Acuity 开发者平台的客户端链接和嵌入，所以让我们继续讨论调度 API方面。

如果您想通过 Acuity 的日程安排、日历和预订功能扩展您自己的网站、服务或移动应用程序的功能，您可以使用 API 来扩展您提供的一组功能和服务。您可以根据自己的选择自定义调度用户界面。

Acuity 的开发人员文档

我建议 从调度API 文档 （如上所示）及其描述如何将其 API 用于常见场景的教程开始。

Acuity 调度 API 资源

还有一个很棒的API 快速入门：

还有详细的功能 API 参考指南：

Acuity 为 PHP 和 node.js 提供特定于语言的开发工具包。 

• 用于 Node.js 的 acuity-js  （在 npm 上）

• 用于 PHP 的 acuity-php  （在 packagegist 上）

每个都包含 API 和实用程序方法的通用接口以及大量示例。

使用 Acuity Scheduling API 安排约会

让我们了解一下使用 PHP SDK 安排约会的基础知识。

入门

要开始使用，您需要 Acuity 用户 ID 和 API 密钥。如果您没有帐户，可以 注册免费试用。

使用 composer 设置 Acuity 的 PHP SDK 非常简单。只需运行 composer require 命令：

$ composer require acuityscheduling/acuityscheduling

创建实例

使用您的 API 密钥，您将实例化该库：

<?php



require('./vendor/autoload.php');



$acuity = new AcuityScheduling(array(

  'userId' => YOUR_USER_ID,

  'apiKey' => 'YOUR_API_KEY'

));

今天我将跳过获取可用性 ，但您可以在他们的教程How to Schedule an Appointment with the Acuity Scheduling API中找到有关此示例的更多详细信息。

安排约会

一旦你有一个可用的时间段，你就可以安排约会。默认情况下，创建约会有几个必填的客户字段：  firstName、 lastName和 email。您还需要 appointmentTypeID 和 可用的 datetime 时间段。

如果您的约会类型有任何自定义摄入表格，您也可以使用该 fields 属性进行设置。

以下是您使用图书馆进行预约的方式：

$appointment = $acuity->request('/appointments', array(

  'method' => 'post',

  'data' => array(

    'firstName' => 'Sam',

    'lastName' => 'Greenbeans',

    'email' => 'sam@examples.org',

    'datetime' => '2016-04-26T19:00:00-0700',

    'appointmentTypeID' => 5,

    'fields' => array(

      array(

        'id' => 4,  // Field ID of my intake form address question

        'value' => '1600 Pennsylvania Avenue'

      )

    )

  )

));

一旦系统中有新的约会，Acuity 的后端服务就会管理重要的事情。管理员可以在后端查看约会，他们会发送自动确认电子邮件并执行任何集成，例如 Acuity 的双向日历同步。

结束时

迄今为止，我们在本系列中了解了很多关于 Acuity Scheduling 的功能。我个人继续对它们的广度和深度印象深刻。 

到目前为止，我们已经回顾了面向消费者的前端调度服务，今天我们涵盖了嵌入式调度、移动集成以及 Acuity 对开发人员友好的 API 的介绍。我们甚至向您展示了如何安排您的第一次约会。

在我们结束这一集时，值得注意的是，一旦系统中有新约会，Acuity 的后端服务就会管理重要的事情。管理员可以在后端查看约会，他们会发送自动确认电子邮件并执行任何集成，例如 Acuity 的 2 向日历同步。

在下一集中，我将描述 Acuity 调度和预订平台的一些剩余方面。我们将介绍 Acuity 的本机oauth 集成，如果您有一个使用自定义应用程序在 Acuity 注册的团队进行日历操作，这将很有帮助。我们将研究如何从 Acuity 中取回数据，用于自定义报告，将其添加到您自己的数据库，或第三方程序，例如为 Acuity 中创建的约会创建 Salesforce事件。我们还将查看 webhook 通知 以了解计划活动何时发生，以及报告 API。