ARI (Asterisk REST Interface) 开源项目实战指南

ARI (Asterisk REST Interface) 开源项目实战指南

项目地址:https://gitcode.com/gh_mirrors/ari/ari

---

项目介绍

ARI（Asterisk REST Interface）是由CyCoreSystems开发的一个强大接口，它使得开发者能够利用RESTful API来操控Asterisk IP通信平台。Asterisk是一个功能齐全的电话交换系统，支持VoIP协议，PSTN硬件，以及多种通信技术。通过ARI，开发者可以轻松创建复杂的语音应用，如IVR（交互式语音应答）、呼叫中心解决方案等，无需深入了解Asterisk内部的工作机制。

---

项目快速启动

快速启动ARI涉及安装必要的软件环境和执行基本的API调用。首先确保您已安装了Asterisk，并且已经启用了ARI模块。

安装与配置Asterisk

确保您的环境中已经安装了Asterisk 16或更高版本，因为这些版本全面支持ARI。配置文件中需启用ARI，这通常在Asterisk的主配置文件(asterisk.conf)中设置。

; 在 asterisk.conf 中启用ARI
[general]
   ...
   ari_enabled = yes

发出第一个API请求

使用curl或者任何支持HTTP客户端的工具，发起一个简单的GET请求以测试连接到ARI服务。

curl -X GET "http://localhost:8088/ari/channels" \
     -H "Accept: application/json" \
     -H "Authorization: Bearer YOUR_AUTH_TOKEN"

注意: YOUR_AUTH_TOKEN需要通过Asterisk的管理界面或通过配置生成。对于初学者，可以考虑使用Asterisk Web Administrative Interface来获取临时令牌。

---

应用案例与最佳实践

IVR建设

ARI非常适合构建自定义的IVR系统。例如，通过创建一个简单的脚本，可以根据来电者的输入路由电话，记录消息，或者提供信息。

{
    "name": "MySimpleIVR",
    "steps": [
        {
            "action": "play",
            "sound": "ivr-welcome"
        },
        {
            "action": "get-digit",
            "timeout": 5,
            "maxattempts": 3,
            "digits": "123",
            "on digits": {
                "1": {
                    "goto": "extension-1"
                },
                "2": {
                    "goto": "extension-2"
                },
                "3": {
                    "hangup": true
                }
            }
        }
    ]
}

这个例子展示了一个基础的数字输入响应流程。

---

典型生态项目

• FreePBX: 这是基于Asterisk的非常流行的PBX界面，支持ARI接口，允许用户通过Web界面设计复杂的通信流程。
• Stasis Apps: ARI社区提供了许多“Stasis”应用程序示例，如simple-recording, queue-stats, 和 click-to-dial, 这些展示了如何实时响应和控制Asterisk通话。

ARI不仅简化了开发工作，而且通过其开放的接口，促进了创新的通信应用的诞生。无论是构建企业级的通讯解决方案，还是开发新型的语音互动服务，ARI都是强大的工具。

---

通过遵循上述指导，开发者可以迅速上手ARI，解锁Asterisk的强大潜力，创造出高效且定制化的通信应用。记得持续关注Asterisk和ARI的更新，以充分利用最新的特性和性能优化。

ari Golang Asterisk REST Interface (ARI) library 项目地址: https://gitcode.com/gh_mirrors/ari/ari