Quick Request · 인덱스
이것은 Quick Request의 UI 핸드북입니다. 앱에서 버튼을 누르고, 폼을 채우고, 스크립트를 쓰세요 — raw JSON 필드는 일절 건드리지 않습니다.
읽는 순서
| 장 | 해결하는 것 |
|---|---|
| quick-start | 첫 걸음: 그룹 생성, 환경 준비, 첫 요청 전송 |
| concepts | /echo만 있는 요청이 왜 동작하는가? {{x}}의 값은 어디에서? |
| scripting | 스크립트가 무엇을 바꿀 수 있는가, UI에서 전송 전 / 응답 후 스크립트 추가 방법 |
| recipes | 로그인 후 토큰 자동 부착, 바디 암호화, 어설션, 랜덤 데이터 — 바로 쓰는 레시피 |
| http · websocket · tcp · udp · grpc · mqtt | 각 프로토콜의 UI 설정·사용법과 주의 사항 |
| 스크립트 API 참조 | Quick Request / 재작성 스크립트의 JavaScript API 시그니처(사이트 내 문서) |
| faq | 문제 해결: 연결 안 됨, 401, 문자 깨짐, 변수 미해석 등 |
전체 멘탈 모델 (한 장 요약)
그룹에는 하나의 환경이 바인딩되고, 환경은 프로토콜별 베이스 주소('Pre-URL')를 공급하며, 요청은 상대 경로와 파라미터만 저장합니다. 전송을 누르면 어셈블 파이프라인이 셋을 조합해 실제 요청으로 만들고, 네트워크 호출 전후로 액션 체인(스크립트 / 추출 / 어설션)을 실행합니다.
핵심: 요청에
http://host/echo가 아니라/echo만 보이는 것은 누락이 아닙니다 — host/port/scheme은 바인딩된 환경의 Pre-URL에서 옵니다. dev/staging/production 전환은 환경 하나의 편집만으로, 그룹 전체가 따라갑니다. concepts 참조.
용어집
| 용어 | 한 줄 정의 |
|---|---|
| 그룹 | 요청의 폴더. 환경은 그룹에 바인딩되며, 그 안의 모든 요청이 공유 |
| 환경 | 'Pre-URL군 + 변수 + 쿠키 정책' 세트로, 하나의 배포 대상을 나타냄 |
| Pre-URL | 환경이 프로토콜별로 정의하는 베이스 주소. 그 scheme이 프로토콜과 TLS 사용 여부를 결정 |
| 요청 | 경로 조각·메서드·헤더·바디·인증·전송 전/후 스크립트를 저장하는 1회의 API 호출 |
| 액션 체인 | 전송 전 / 응답 후의 순서 있는 스텝: 스크립트, 라이브러리 스크립트, 추출, 어설션, 대기 |
| 변수 레이어 | 환경 변수(영속) / 런타임 변수(메모리 내·요청 간) / 전송 시 변수(그 자리 한정) |