Trình bao bọc gốc cho API Ajoxi. Thiết lập và chạy trong vài phút với ứng dụng khách an toàn loại và xác minh webhook tích hợp sẵn.
Diện tích bề mặt giống nhau trên cả bốn ngôn ngữ. Cùng một nhịp phát hành. SLA tương tự.
$ npm install @ajoxi/sdk$ pip install ajoxi$ go get github.com/ajoxi/ajoxi-go$ gem install ajoxiThao tác giống nhau trên mọi SDK — khởi tạo ứng dụng khách, gọi calls.create, ghi lại kết quả. Chọn một ngôn ngữ và sao chép đoạn mã.
Các phím chế độ kiểm tra (AJX_TEST_…) thực hiện cuộc gọi đối với trình mô phỏng của chúng tôi. Họ không bao giờ gọi đến điện thoại thật và không tính phí theo phút cho phép của bạn — hoàn hảo cho CI.
import Ajoxi from '@ajoxi/sdk';
const ajoxi = new Ajoxi({ apiKey: process.env.AJOXI_KEY });
const call = await ajoxi.calls.create({
to: '+14155551234',
from: '+14155550100',
aiReceptionist: true,
});
console.log(call.id, call.status);Mỗi SDK Ajoxiđều cung cấp các nguyên tắc hoạt động giống nhau để bạn có thể tập trung vào logic kinh doanh của mình.
Định nghĩa kiểu đầy đủ cho mọi điểm cuối và phản hồi - không cần đoán tên trường.
Lỗi mạng và lỗi 5xx tự động thử lại với thời gian chờ theo cấp số nhân, tôn trọng Thử lại sau.
Xác minh chữ ký HMAC-SHA256 một dòng với khả năng so sánh theo thời gian liên tục.
Lặp lại qua hàng triệu bản ghi mà không cần viết một vòng lặp con trỏ nào.
Mọi yêu cầu đều trả về X-Request-Id mà bạn có thể trích dẫn để hỗ trợ - hiển thị trên mọi lỗi.
Chuyển đổi giữa các khóa kiểm tra và khóa sản xuất bằng một đối số hàm tạo.
Nếu bạn muốn làm việc với Rust, PHP, .NET hoặc Elixir, cộng đồng sẽ hỗ trợ bạn. Đây không phải là bên thứ nhất và có thể tụt hậu về các tính năng mới — ghim vào phiên bản thử nghiệm đang được sản xuất.
cargo add ajoxi-rsĐược duy trì bởi cộng đồng @Ajoxicomposer require ajoxi/ajoxi-phpĐược duy trì bởi cộng đồng @Ajoxidotnet add package AjoxiĐược duy trì bởi cộng đồng @Ajoximix deps.get ajoxi_exĐược duy trì bởi cộng đồng @AjoxiChọn một cái phù hợp với thời gian chạy của bạn. Node.js và Python nhận được các bản cập nhật tính năng đầu tiên và có mức sử dụng rộng rãi nhất. Go và Ruby vận chuyển cùng một diện tích bề mặt trong một hoặc hai bản phát hành. Cả bốn đều là của bên thứ nhất — được duy trì bởi nhóm Ajoxivới cùng SLA hỗ trợ.
Nó được gắn nhãn beta vì API công khai chưa bị đóng băng - chúng tôi có thể đổi tên một hoặc hai tham số trước v1.0. Về mặt chức năng, nó bao gồm mọi điểm cuối và đã chạy trong hệ thống nội bộ của chúng tôi trong hơn một năm. Sử dụng sản xuất ổn; ghim vào một phiên bản nhỏ.
SDK nhắm mục tiêu phiên bản API ổn định mới nhất (hiện tại là v1). Khi có phiên bản API mới xuất xưởng, người bảo trì SDK sẽ cập nhật ứng dụng khách trong vòng hai chu kỳ phát hành — bạn không cần phải chọn. SDK hỗ trợ ghim một phiên bản API cụ thể thông qua tùy chọn hàm tạo để di chuyển.
Đúng. Node.js theo mặc định là không đồng bộ (tất cả các phương thức đều trả về Lời hứa). Python cung cấp cả máy khách đồng bộ và không đồng bộ (`Ajoxi` và `AsyncAjoxi`). Go có khả năng nhận biết ngữ cảnh trong mọi cuộc gọi. Ruby đồng bộ với tính năng đồng thời dựa trên Fiber có sẵn thông qua đá quý `Ajoxi-async` tùy chọn.
SDK Node.js cung cấp các loại TypeScript được quản lý thủ công bao gồm mọi điểm cuối, yêu cầu và phản hồi. Thu hẹp loại trên các phản hồi hợp nhất hoạt động như bạn mong đợi. Các loại đã tạo cũng được xuất bản riêng thành `@Ajoxi/sdk-types` cho các dự án muốn có các loại không có ứng dụng khách thời gian chạy.
Có — cả bốn SDK đều là nguồn mở trên GitHub. Các vấn đề và PR đều được chào đón. Chúng tôi có quyền viết lại chi tiết triển khai để thống nhất với các mẫu nội bộ, nhưng diện tích bề mặt được công bố sẽ được coi như một hợp đồng.
Hoàn thành khóa hộp cát và gửi bản tích hợp hoạt động trước cuối ngày.