4개 언어 모두에서 표면적이 동일합니다. 동일한 릴리스 케이던스. 동일한 SLA.
$ npm install @ajoxi/sdk$ pip install ajoxi$ go get github.com/ajoxi/ajoxi-go모든 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);모든 AjoxiSDK는 동일한 운영 기본 요소를 제공하므로 비즈니스 로직에 집중할 수 있습니다.
모든 엔드포인트 및 응답에 대한 전체 유형 정의 - 필드 이름을 추측할 필요가 없습니다.
네트워크 오류 및 5xx 오류는 Retry-After를 고려하여 지수 백오프를 사용하여 자동으로 재시도합니다.
상수 시간 비교를 통한 한 줄 HMAC-SHA256 서명 검증.
단일 커서 루프를 작성하지 않고 수백만 개의 레코드를 반복합니다.
모든 요청은 지원을 위해 인용할 수 있는 X-Request-Id를 반환하며 이는 모든 오류에 표시됩니다.
하나의 생성자 인수를 사용하여 테스트 키와 프로덕션 키 간을 전환합니다.
Rust, PHP, .NET 또는 Elixir에서 작업하고 싶다면 커뮤니티에서 도와드리겠습니다. 이는 자사 제품이 아니며 새로운 기능이 뒤처질 수 있습니다. 프로덕션 환경에서 테스트된 버전에 고정됩니다.
cargo add ajoxi-rs@Ajoxi-커뮤니티에서 관리함composer require ajoxi/ajoxi-php@Ajoxi-커뮤니티에서 관리함dotnet add package Ajoxi@Ajoxi-커뮤니티에서 관리함mix deps.get ajoxi_ex@Ajoxi-커뮤니티에서 관리함런타임에 맞는 것을 선택하세요. Node.js와 Python은 기능 업데이트를 먼저 받고 프로덕션 용도가 가장 넓습니다. Go와 Ruby는 한두 릴리스 내에서 동일한 표면적을 제공합니다. 4개 모두 자사 제품이며 동일한 지원 SLA를 사용하여 Ajoxi팀에서 유지 관리합니다.
공개 API가 고정되지 않았기 때문에 베타라고 표시되어 있습니다. v1.0 이전에는 하나 또는 두 개의 매개변수 이름을 바꿀 수 있습니다. 기능적으로는 모든 엔드포인트를 포괄하며 1년 넘게 자체 내부 파이프라인에서 실행되어 왔습니다. 프로덕션 용도로는 괜찮습니다. 마이너 버전으로 고정하세요.
SDK는 안정적인 최신 API 버전(현재 v1)을 대상으로 합니다. 새 API 버전이 출시되면 SDK 유지 관리자는 두 번의 릴리스 주기 내에 클라이언트를 업데이트하므로 사용자가 선택할 필요는 없습니다. SDK는 마이그레이션을 위한 생성자 옵션을 통해 특정 API 버전 고정을 지원합니다.
예. Node.js는 기본적으로 비동기식입니다(모든 메소드가 Promises를 반환함). Python은 동기화 및 비동기 클라이언트(`Ajoxi` 및 `AsyncAjoxi`)를 모두 제공합니다. Go는 모든 호출에서 상황을 인식합니다. Ruby는 선택적 `Ajoxi-async` gem을 통해 사용할 수 있는 Fiber 기반 동시성과 동기화됩니다.
Node.js SDK는 모든 엔드포인트, 요청 및 응답을 다루는 손으로 선별한 TypeScript 유형과 함께 제공됩니다. Union 응답에 대한 유형 축소는 예상대로 작동합니다. 생성된 유형은 런타임 클라이언트 없이 유형을 원하는 프로젝트의 경우 '@Ajoxi/sdk-types'에 별도로 게시됩니다.
예. 네 가지 SDK는 모두 GitHub의 오픈 소스입니다. 이슈와 PR을 환영합니다. 우리는 내부 패턴과의 일관성을 위해 구현 세부 사항을 다시 작성할 권리를 보유하지만 게시된 노출 영역은 계약으로 간주됩니다.
하루가 끝나기 전에 샌드박스 키를 가동하고 작동하는 통합을 출시하세요.