Vonage Ruby SDK 버전 7.3.0 발표

Vonage Ruby SDK는 최근 새 릴리스 v7.3.0을 발표했습니다.
이 새 버전에는 API 목록 메서드에 대한 자동 페이지 매김 기능이 도입되어 Vonage API에서 데이터를 보다 능률적으로 수집할 수 있습니다.

그 이유와 작동 원리를 살펴보겠습니다.

자동 페이지 매김을 도입하는 이유는 무엇입니까?

Vonage API로 작업할 때 페이지 매김에 대해 생각해야 하는 이유는 무엇이며 자동 페이지 매김은 경험을 어떻게 개선합니까?

실제 사례를 보면 가장 잘 이해할 수 있습니다.

Vonage 음성 API에는 get details of all your calls 기능이 있습니다. 매개변수 없이 API에 이GET 요청을 하면 기본적으로 처음 10개만 반환합니다.

전화가 10개 이상 있으면 어떻게 됩니까? 레코드의 추가 페이지마다 후속 API 요청을 계속해야 합니다. 즉, 현재 페이지, 남은 페이지 수 및 페이지당 레코드 수를 추적합니다. 통화 목록만 있으면 예상보다 인지 부하가 ​​더 클 수 있습니다.

다행히도 이 작업은 이제 Ruby SDK v7.3.0에서 귀하의 책임에서 추상화되었습니다.

Vonage SDK 팀이 blog post에서 설명한 것처럼, 우리는 우리 SDK가 주로 개발자로서의 삶을 더 쉽게 만들고 가능한 한 고통 없이 작업을 완료할 수 있도록 해야 한다고 굳게 믿습니다. Ruby SDK의 자동 페이지 매김은 그 큰 목표를 향한 또 다른 단계입니다.

어떻게 작동합니까?

Ruby SDK에 새로운 기능을 도입함에 따라 정기적으로 Ruby SDK를 사용하여 작업을 완료하는 모든 사람의 워크플로에 영향을 최소화하는 것이 중요합니다. 따라서 자동 페이지 매김은 개선 사항을 활용하기 위해 거의 할 일이 없습니다.

이제 SDK에서 사용한 것과 동일한 메서드 호출로 모든 전화 통화 기록을 요청할 수 있습니다.

client = Vonage::Client.new
client.applications.list

그러나 이제 SDK는 모든 레코드 페이지를 자동으로 진행하여 반환된 호출 모음에 추가합니다. 이전에는 이 메서드 호출이 API에 대한 기본 레코드 수(이 경우 10개)만 반환했으며 나머지 레코드를 수집하려면 더 많은 API 요청을 해야 했습니다.

모든 기록을 반환하고 싶지 않은 상황이 있습니다. auto_advance: false 메서드 호출에서 추가 인수를 전달하여 자동 페이지 매김을 끌 수 있습니다. 예를 들어 처음 5개의 호출만 반환하려는 경우 메서드는 다음과 같습니다.

client = Vonage::Client.new
client.applications.list(page_size: 5, auto_advance: false)

기본 동작을 특별히 원하지 않는 경우 코드에 auto_advance 인수만 추가하면 됩니다. 대부분의 API에서 기본 동작은 자동 진행입니다.

무엇 향후 계획?

Ruby SDK 작업에 더 흥미로운 계획이 있습니다! 우리는 당신을 위해 HTTP 요청을 할 뿐만 아니라 주로 당신의 작업을 더 쉽고 더 능률적으로 만드는 리소스가 되는 우리의 목표와 일치를 높이기 위해 SDK의 기능을 계속해서 구축하고 있습니다.

커뮤니티 참여를 언제나 환영합니다. GitHub 및 Vonage Community Slack에서 자유롭게 참여하십시오.