빠른 시작 (5 분)

목표는 갓 설치한 상태에서 출발해, URL과 토큰을 변수에서 가져오는 인증된 요청까지 도달하는 것입니다. 5 분 정도 걸립니다.

1. 프로젝트 만들기

파일 ▸ 새로 만들기(Ctrl+N) 를 고른 다음, 파일 ▸ 다른 이름으로 저장 (Ctrl+Shift+S) 으로 demo.restorm 처럼 이름을 지정하십시오.

프로젝트는 디스크에 놓인 단순한 파일입니다. 지금 바로 git 저장소에 넣어도 됩니다. Restorm은 바로 그것을 위해 만들어졌습니다.

2. 변수 폴더 만들기

사이드바 트리에서 오른쪽 클릭하고 추가 ▸ 환경 폴더를 선택하십시오.

변수 폴더(또는 환경 폴더)는 local, staging, production 같은 환경, 따라서 {{variables}} 를 담는 컨테이너입니다. 그 안에 있는 모든 요청이 선택된 환경을 상속합니다.

이 폴더를 열고 local 환경을 만든 뒤, 변수 하나를 추가하십시오.

키	유형	값
baseUrl	문자열	https://api.exemple.test

3. 요청을 만들어 보내기

폴더를 오른쪽 클릭하고 추가 ▸ HTTP 요청을 선택하십시오. 열린 탭에서 다음과 같이 진행합니다.

• 메서드는 GET 그대로 둡니다.
• URL에 {{baseUrl}}/health 를 입력합니다. 해석된 값이 입력란 아래에 표시되며, 이것이 안전망 역할을 합니다.
• 보내기를 클릭합니다.

응답이 그 아래에 펼쳐집니다. 상태 코드, 소요 시간, 크기, 헤더, 그리고 접었다 펼 수 있는 JSON 뷰어로 렌더링된 본문이 나타납니다.

4. 인증 추가하기

토큰을 하드코딩해 붙여 넣는 대신 인증 요청을 만드십시오. 오른쪽 클릭하고 추가 ▸ HTTP 인증 요청을 선택합니다. 토큰을 받아 오는 호출(예를 들어 POST /oauth/token)을 구성한 뒤, 그 요청의 설정 탭에서 이 요청이 만들어 내는 것을 선언하십시오.

생성되는 헤더	값
Authorization	{{token_type}} {{access_token}}

이 값은 인증 요청의 응답 본문에 대해 평가되는 표현식입니다. 이때 만료 표현식(예를 들어 {{expires_in}})도 함께 지정해 두면 Restorm이 토큰을 알아서 갱신합니다.

GET 요청으로 돌아가 상단 바에서 이 인증 경로를 선택하십시오. 이제 보낼 때마다 헤더가 주입되고, 401 이 돌아오면 자동으로 갱신 후 재시도가 이루어집니다.

자세한 내용은 인증을 참고하십시오.

5. 더 나아가기

• 이미 명세나 컬렉션을 가지고 계십니까? 파일 ▸ 가져오기(Ctrl+I) 가 트리 전체를 다시 구성해 줍니다. 가져오기 및 내보내기를 참고하십시오.
• 여러 호출을 연결하고 결과를 검증하려면 시나리오를 사용하십시오.
• 그 시나리오를 CI에서 돌려 보십시오. 헤드리스 실행을 참고하십시오.