Pizzly 소개 - 오프소스, 무료, 빠르고 간단한 API 통합 관리자

우리 회사 Bearer에서 전체 팀은 제3자 API에 의존하는 개발자를 돕는 데 주력한다.2019년에 저희 엔지니어는 OAuth를 사용하는 모든 API와의 통합을 간소화하는 솔루션을 개발했습니다.
API 통합을 사용할 때 인증 정책 처리(리셋 영패 사용)와 에이전트 요청을 통해 몇 시간의 공사 시간을 절약할 수 있다.
우리는 어떤 개발자도 OAuth API를 통합하는 세부 사항을 처리하는 데 몇 시간을 들여서는 안 된다고 생각하기 때문에, 우리는 우리의 도구의 원본 코드를 완전히 개방하기로 결정했다.소개Pizzly: The OAuth Integration Proxy.

수취인 / 피즐리

어플리케이션을 OAuth API와 통합하는 가장 간단하고 빠른 방법😋

Pizzly가 뭐예요?

Pizzly는 OAuth 통합 관리자입니다.이것은 개발자가 OAuth 기반의 API(OAuth를 인증 방법으로 사용하는 API라고도 함)를 쉽게 사용하는 데 필요한 모든 것을 제공한다.
대부분의 API는 현재 사용자 데이터에 액세스하려는 애플리케이션에 대한 권한을 부여하기 위해 OAuth framework 을 사용하고 있습니다.그 중 하나는 OAuth가 최상의 사용자 체험을 제공하고 매우 안전하기 때문이다.그러나 OAuth 프레임워크에서 한 가지 완전히 잊어버린 것은 개발자 체험이다.
개발자에게 OAuth 기반 API를 사용하는 것은 API 키에 의존하는 API를 사용하는 것보다 훨씬 어렵다.두 API와 통합하는 데 시간이 얼마나 걸립니까?Google Sheets API에 비해 Stripe API를 처음 요청하는 데 얼마나 걸릴지 살펴보겠습니다.

Pizzly 없는 첫 번째 API 호출 시간(TTFAC)
0부터 Google Sheets에 인증 요청 source 을 실행하는 데 약 43분 19초가 걸렸습니다.줄무늬source는 5분밖에 걸리지 않는다.우리는 반드시 이 점을 바꿔야 한다.
Pizzly는 OAuth 기반 API를 사용할 때 최상의 개발자 경험을 제공하기 위한 것입니다.그것의 강력한 기능은 OAuth 댄스 (리셋 영패 포함) 를 완전히 처리하는 것이다. 이것은 개발자가 요청 노드에 전념할 수 있고 몇 시간 동안 신분 검증을 처리할 필요가 없다는 것을 의미한다.
다음은 Pizzly를 사용한 동일한 테스트입니다.

Pizzly의 첫 번째 API 호출 시간(TTFAC)
Stripe에 비해 Google Sheets API에 대한 인증 요청을 수행하는 데 거의 같은 시간(5분 대 7분)이 걸렸습니다. Pizzly부터.마찬가지로 이것은 source이다.이전 테스트와 반대로 Pizzly를 사용하면 영패가 만료된 후에 리셋됩니다.

그것은 어떻게 일합니까?

Pizzly는 개발자의 API 통합을 지원하는 다양한 도구를 제공합니다.

auth 서비스 - OAuth 무용 처리;

에이전트 - API에 검증된 요청 보내기;

대시보드 - API 활성화 및 구성,

JS 라이브러리 - 프런트엔드에서 사용자를 연결합니다.

두 가지 주요 서비스는 Auth 및 Proxy입니다.

사용자가 OAuth 응용 프로그램에 권한을 부여할 때마다 auth 서비스는 OAuth 춤을 처리하고 이른바 authId을 생성합니다.authId OAuth 유효 하중의 참조로 사용됩니다 (즉, access token 및 refresh token.방문 영패와 리셋 영패가 만료되고 시간에 따라 변경될 때 authId는 항상 같습니다.사용자로 간주할 수 있습니다.

프록시 서비스는 HTTP 요청을 타사 API에 전달합니다.검증 요청을 위해 개발자가 동시에 발송authId.이것은 에이전트 서비스 전환 요청을 알려주고 정확한 접근 영패를 사용하여 인증합니다.토큰이 만료되면 Pizzly는 토큰을 새로 고치고 요청을 다시 시도합니다.

Pizzly가 가져온 또 다른 좋은 도구는 계기판이다.

대시보드를 사용하면 통합을 구성하고 테스트하며 현재 진행 중인 일을 볼 수 있습니다.

어떻게 사용합니까?

Pizzly는 자체적으로 관리되는 것으로 기계나 플랫폼, 즉 서비스(예를 들어 Heroku, AWS 등)에 설치할 수 있음을 의미합니다.이것은 how to get started의 지침입니다.
설치 후 목록에서 API를 활성화하고 Pizzly JS 라이브러리를 사용하여 몇 줄 코드에서 전체 OAuth 댄스를 트리거합니다.

// Initialize Pizzly
const pizzly = new Pizzly({ host: "pizzly.example.org" }) 
const api = pizzly.integration('api')

// Connect a user to an API
api
  .connect()
  .then(({ authId }) => console.log("Sucessfully connected!", authId))
  .catch((error) => console.error("It failed!", error))

사용자가 성공적으로 연결되면 API에 인증된 요청을 보낼 수 있도록 authId 를 검색할 수 있습니다.다음은 사용자 드라이브에 스프레드시트를 작성하기 위해 Google Sheets API에 요청을 보내는 방법에 대한 예입니다.

curl -X POST /proxy/google-sheets/ \\
 -H "Pizzly-Auth-Id: REPLACE-WITH-YOUR-AUTH-ID"

백엔드가 어떤 플랫폼에서 실행되든 (Ruby, Go, Node.js) 요청을 에이전트에 보내야 합니다.이는 통합 API의 속도를 크게 향상시킵니다.당신은 심지어 JS client 를 사용하여 전방에서 통화를 실행할 수 있습니다.

일부 프레젠테이션

일부 위대한 프로젝트는 Pizzly를 사용하여 API 요청을 처리하고 있습니다.

Airtable Shipping Block

또는 의 GitHub에서 구성 파일 가져오기(자습서)

Psst.Bearer.sh 에서 Pizzly는 API 통합 프로세스의 전체 부분입니다. 예를 들어 느슨한 알림을 관리하는 데 사용됩니다.

이것은 너에게 무슨 도움이 있니?

Pizzly는 50여 개의 기존 API를 지원합니다.대시보드에 자격 증명과 역할 영역만 설정하면 됩니다.이 목록에는 다음과 같은 가장 일반적인 API가 포함됩니다.

통신 API: Gmail, 마이크로소프트 팀, Slack, Zoom;

CRM: Front, Hubspot, Salesforce 등

개발 도구: BitBucket, GitHub, GitLab 등

재무 API: Xero, Sellsy, Zoho Books 등

생산력: Asana, Google Drive, Google Sheets, Jira, Trello 등

소셜 API: Facebook, LinkedIn, Reddit 등

and more...

하지만 이게 다가 아니야.각 사전 구성된 API는 within the .json folder에 있는 /integrations/ 파일입니다.따라서 사전 구성되지 않은 API를 원하는 경우 구성을 디렉토리의 새 .json 파일로 설정할 수 있습니다.공유하고 싶다면, 새로운 홍보관을 만들고 지역 사회와 자신의 설정을 공유하세요.

내장

노드.회사 명⚡️

Passport.js - OAuth 댄스 처리🕺

Knex - 데이터베이스 요청 관리📃

EJS - 대시보드 템플릿용⚙️

바닐라 자바스크립트. - 뭔가 신기해.🍦

우리를 지지하다

Star the repo on GitHub, 트위터, 친구, 팀, 연락처 사이에서 공유!
너도 이메일[email protected]이나 트위터를 통해 나에게 직접 연락할 수 있다.만약 당신이 정말로 우리를 도와 Pizzly를 더욱 좋아지게 하고 싶다면, contribute to the GitHub repo!