Власні оболонки для API Ajoxi. Почніть працювати за лічені хвилини з безпечними клієнтами та вбудованою перевіркою через веб-хук.
Однакова площа для всіх чотирьох мов. Та сама частота випуску. Той самий SLA.
$ npm install @ajoxi/sdk$ pip install ajoxi$ go get github.com/ajoxi/ajoxi-go$ gem install ajoxiТа сама операція в кожному SDK — ініціалізація клієнта, виклик calls.create, зареєструйте результат. Виберіть мову та скопіюйте фрагмент.
Клавіші тестового режиму (AJX_TEST_…) здійснювати дзвінки проти нашого симулятора. Вони ніколи не дзвонять на справжній телефон і не виставляють рахунок за вашу хвилину — ідеально підходить для 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);Кожен Ajoxi SDK постачає однакові операційні примітиви, тож ви можете зосередитися на своїй бізнес-логіці.
Повні визначення типів для кожної кінцевої точки та відповіді — без вгадування назв полів.
Мережні спалахи та помилки 5xx повторюють автоматичну спробу з експоненційною відстрочкою, дотримуючись Retry-After.
Однорядкова перевірка підпису HMAC-SHA256 із порівнянням у постійному часі.
Перебирайте мільйони записів, не створюючи жодного циклу курсору.
Кожен запит повертає ідентифікатор X-Request-Id, який ви можете передати в службу підтримки — з’являється під час кожної помилки.
Перемикайтеся між тестовими ключами та робочими ключами за допомогою одного аргументу конструктора.
Якщо ви бажаєте працювати в Rust, PHP, .NET або Elixir, спільнота допоможе вам. Вони не першої сторони і можуть відставати від нових функцій — прикріпіть до перевіреної версії в робочій версії.
cargo add ajoxi-rsПідтримується спільнотою @ajoxicomposer require ajoxi/ajoxi-phpПідтримується спільнотою @ajoxidotnet add package AjoxiПідтримується спільнотою @ajoximix deps.get ajoxi_exПідтримується спільнотою @ajoxiВиберіть той, який відповідає вашому часу виконання. Node.js і Python першими отримують оновлення функцій і мають найширше робоче використання. Go і Ruby відправляють однакову площу поверхні протягом одного або двох випусків. Усі чотири належать першій стороні — обслуговуються командою Ajoxi з однаковою підтримкою SLA.
Його позначено як бета-версію, оскільки публічний API не було заморожено — ми можемо перейменувати один або два параметри до версії 1.0. Функціонально він охоплює кожну кінцеву точку та працює в наших власних внутрішніх конвеєрах більше року. Виробниче використання добре; закріпити до другорядної версії.
SDK націлені на останню стабільну версію API (наразі v1). Коли постачається нова версія API, супроводжувачі SDK оновлюють клієнти протягом двох циклів випуску — вам не потрібно вибирати. Пакети SDK підтримують закріплення певної версії API за допомогою опції конструктора для міграцій.
так Node.js є асинхронним за замовчуванням (усі методи повертають Promises). Python постачає як синхронізовані, так і асинхронні клієнти («Ajoxi» і «AsyncAjoxi»). Go працює з урахуванням контексту під час кожного виклику. Ruby синхронізується з паралелізмом на основі Fiber, доступним через додатковий gem `ajoxi-async`.
Node.js SDK постачається з підібраними вручну типами TypeScript, які охоплюють кожну кінцеву точку, запит і відповідь. Звуження типів у відповідях профспілки працює так, як ви очікували. Згенеровані типи також публікуються окремо в `@ajoxi/sdk-types` для проектів, яким потрібні типи без клієнта середовища виконання.
Так — усі чотири SDK є відкритими на GitHub. Проблеми та PR вітаються. Ми залишаємо за собою право переписати деталі реалізації для узгодженості з внутрішніми шаблонами, але опублікована площа розглядається як договір.
Розкрутіть ключ пісочниці та надішліть робочу інтеграцію до кінця дня.