로켓펀치 Open API 시작하기

먼저 알아두실 것 — 주소가 세 개입니다

역할이 다른 세 개의 주소를 사용합니다. 헷갈리기 쉬운 부분이라 먼저 정리해 드릴게요.

주소	역할	언제 쓰나요
`openapi.rocketpunch.com`	API 서버	실제 데이터를 호출할 때. `/api/v1/...` 요청과 토큰 발급(`/oauth/token`)을 보냅니다.
`developers.rocketpunch.com`	개발자 콘솔	앱을 등록하고 App Key를 발급 · 관리할 때. 사용자 동의 화면(`/oauth/authorize`)도 이곳입니다.
`docs.rocketpunch.com`	문서	지금 보고 계신 이 문서입니다.

토큰 발급(/oauth/token)은 API 서버, 사용자 동의(/oauth/authorize)는 개발자 콘솔입니다. 두 주소가 서로 다르니 연동할 때 주의해 주세요.

두 가지 인증 방식

무엇을 하려는지에 따라 인증 방식이 달라집니다.

각 API가 어떤 인증을 요구하는지는 API 레퍼런스의 security 항목에서 확인할 수 있습니다.

다음 단계

빠른 시작

App Key를 발급받고 첫 API를 호출하기까지 3단계로 안내합니다.

App Key 전용 앱과 OAuth 클라이언트 앱 중 무엇을 만들지 정합니다.

발급받은 키를 헤더에 담아 호출하고, 안전하게 보관 · 회전합니다.

사용자 동의를 받아 사용자 컨텍스트 API를 호출합니다.

엔드포인트 목록 · 요청/응답 스키마 · Rate Limit · 에러 코드 같은 상세 명세는 API 레퍼런스에서 확인할 수 있습니다.