API가 보내 준 상태 코드와 JSON 내용을 직접 확인해야 한다면 무료 HTTP 클라이언트 Cartero를 사용할 수 있습니다. Linux에서 요청 방식과 URL을 정해 Send를 누른 뒤 응답 본문과 헤더를 한 화면에서 살펴보는 프로그램입니다. 개발자가 안내하는 공식 Flathub 배포를 통해 설치할 수 있습니다.
이 글은 본인이 관리하거나 테스트 권한이 있는 API의 GET 요청을 먼저 보내고 결과를 읽는 순서로 설명합니다. 확인한 stable 버전은 26.0이며 Flathub는 Linux x86_64와 aarch64를 지원합니다. 실제 서비스에 요청을 보내기 전에는 주소와 권한, 데이터가 바뀌는 요청인지 확인하세요.
Cartero로 무엇을 확인할 수 있나요?
Cartero는 요청 방식을 고르고 URL을 입력해 서버에 HTTP 요청을 보내는 그래픽 프로그램입니다. 개발자 설명서에는 REST·SOAP·XML-RPC API를 시험할 수 있고 요청 헤더와 본문을 설정할 수 있다고 나옵니다. 명령어를 외우지 않고 요청 값과 서버가 돌려준 결과를 나란히 보고 싶을 때 쓸 수 있습니다.
공식 첫 화면에는 GET 선택 메뉴, URL 입력칸, 파란 Send 버튼이 보입니다. 왼쪽은 Parameters·Headers·Variables·Authorization·Body 같은 요청 설정이고 오른쪽은 응답 Body·Headers입니다. 화면 오른쪽 위에는 HTTP 상태 코드와 걸린 시간, 응답 크기가 표시됩니다.
두 번째 공식 화면은 Accept 헤더를 켠 사례이고 세 번째는 POST 요청에 JSON 본문을 붙였지만 서버에서 HTTP 400을 돌려준 사례입니다. 400은 그 화면에서 받은 서버 응답이지 Cartero 설치 실패를 뜻하지 않습니다. 처음에는 데이터가 바뀌지 않는 본인 테스트용 GET 주소로 화면 구조부터 익히세요.
Cartero 공식 GET·헤더·JSON 요청 화면
Cartero 공식 Flathub 화면입니다. 첫 장은 GET 요청 후 HTTP 200과 JSON 본문, 둘째 장은 요청 Headers의 Accept 값, 셋째 장은 POST JSON 본문과 서버의 HTTP 400 응답을 보여 줍니다. 화면 속 주소와 데이터는 설명용 예시입니다.
| 프로그램 | Cartero |
| 제공 | Dani Rodríguez |
| 지원 플랫폼 | Linux x86_64·aarch64 |
| 배포 경로 | 공식 Flathub stable Flatpak |
| 확인 버전 | 26.0 |
| 앱 ID | es.danirod.Cartero |
Cartero 공식 무료 배포와 Linux 설치 확인
Cartero 개발자 사이트의 Download 페이지는 GNU/Linux용 Flathub 경로를 직접 안내합니다. 26.0 공식 설명서는 Flathub의 Flatpak 배포를 공식 버전이라고 명시합니다. Flathub에서 Free 표시와 제공자 Dani Rodríguez, 앱 ID es.danirod.Cartero가 일치하는지 확인하세요.
지원 아키텍처는 Linux x86_64와 aarch64입니다. 이 글의 stable .flatpakref는 앱 전체가 들어 있는 실행 파일이 아니라 Flathub 설치 대상을 가리키는 참조 파일입니다. Linux에서 Flatpak과 Flathub 저장소를 먼저 준비한 뒤 소프트웨어 앱에서 설치를 끝내야 합니다.
개발자 설명서에는 소프트웨어 앱에서 Cartero를 찾거나 flatpak install es.danirod.Cartero 명령을 사용하는 방법도 나옵니다. 배포판마다 설치 화면의 버튼 이름은 다를 수 있으니 앱 이름과 ID를 기준으로 대조하세요. 설치 뒤 앱 목록에서 Cartero를 열면 됩니다.
- 개발자 Download 페이지와 Flathub에서 Cartero 무료 stable 배포를 확인합니다.
- Linux에 Flatpak·Flathub를 준비하고 앱 ID es.danirod.Cartero를 설치합니다.
- 앱 목록에서 Cartero를 열어 새 요청 화면을 확인합니다.
GET 요청을 보내고 상태 코드 확인하기
처음 화면에서 New tab을 눌러 요청 탭을 만들 수 있습니다. 26.0 설명서는 Ctrl+T도 새 탭을 여는 방법으로 안내합니다. 요청 방식 메뉴에서 GET을 고르고, URL 칸에 본인이 관리하거나 시험해도 되는 API 주소를 입력하세요. 빈 URL에서는 전송 동작이 활성화되지 않습니다.
설정이 맞으면 Send를 누르거나 Ctrl+Enter로 요청을 보냅니다. 이 동작은 실제 네트워크 요청을 발생시키므로 운영 서비스의 주소를 연습용으로 쓰지 않는 편이 좋습니다. 서버가 인증을 요구한다면 먼저 그 API 문서에서 허용된 접근 방법을 확인하세요.
응답이 오면 오른쪽 위의 HTTP 상태 코드, 걸린 시간과 크기를 먼저 봅니다. 공식 예시의 HTTP 200은 그 요청에 서버가 성공 응답을 보냈다는 뜻입니다. 200이라도 본문이 기대한 자료인지 확인해야 작업이 끝납니다. 오류 코드가 보이면 오른쪽 Body 내용과 서버의 메시지를 함께 읽으세요.
오른쪽 Body 탭에는 응답 내용이, Headers 탭에는 서버가 보낸 응답 헤더가 나타납니다. JSON이라면 Cartero가 읽기 쉽게 정렬해 보여 줄 수 있습니다. 숫자만 보고 API가 정상이라고 결론내지 말고 필요한 필드가 들어왔는지, 요청한 주소가 맞는지까지 대조하세요.
서버가 이미지나 압축 파일처럼 텍스트가 아닌 자료를 돌려주면 Body에 긴 글자가 보이는 대신 바이너리 응답 경고가 나올 수 있습니다. 개발자 설명서는 이런 경우 Export to file로 응답을 저장해 적절한 도구에서 확인할 수 있다고 안내합니다. JSON이 보이지 않는다고 곧바로 요청이 실패한 것으로 판단하지 말고, 먼저 상태 코드와 응답 형식을 확인하세요. 저장한 파일의 확장자와 내용이 서버가 예고한 형식에 맞는지도 살펴보세요.
- New tab에서 GET을 고르고 권한이 있는 테스트 API URL을 넣습니다.
- Send를 누른 뒤 오른쪽 위의 상태 코드와 응답 시간을 확인합니다.
- Body와 Headers를 열어 실제 자료와 응답 조건을 살펴봅니다.
요청 헤더와 매개변수를 바꿔 다시 시험하기
주소에 검색 조건이 들어가는 API라면 왼쪽 Parameters 탭에서 매개변수 이름과 값을 살펴볼 수 있습니다. 설명서에 따르면 행의 체크를 끄면 해당 매개변수를 잠시 요청에서 제외할 수 있습니다. 값을 바꾼 뒤 다시 Send를 눌러 응답 차이를 확인하세요.
요청 헤더가 필요한 경우에는 왼쪽 Headers 탭을 사용합니다. 공식 두 번째 화면은 Accept 항목에 application/activity+json을 적고 체크한 예입니다. 모든 API에 이 값을 넣으라는 뜻은 아닙니다. 사용 중인 API 문서에서 요구하는 헤더 이름과 값만 적용하세요.
Authorization 탭은 인증 방법을 설정할 때 쓰지만 실제 토큰이나 암호를 설명용 문서와 공유 화면에 넣지 마세요. 개발자 설명서는 일부 값의 가리기 표시가 화면상 마스킹일 뿐, 저장된 요청 파일에는 값이 평문으로 남을 수 있다고 주의합니다. 민감한 값을 보관해야 한다면 공식 변수와 .env 사용 안내를 먼저 읽으세요.
요청을 조금씩 바꿔 비교할 때에는 URL, 방식, 헤더 가운데 무엇을 바꿨는지 한 번에 하나씩 확인하면 원인을 찾기 쉽습니다. 상태 코드만 달라졌는지, 본문 필드도 달라졌는지 분리해 보면 서버가 어떤 조건을 받아들였는지 이해할 수 있습니다.
- Parameters 또는 Headers에서 API 문서가 요구하는 값을 설정합니다.
- 활성 체크와 URL을 확인한 뒤 요청을 다시 보냅니다.
- 앞선 응답과 상태 코드·Body 내용을 비교합니다.
POST JSON 본문과 오류 응답 읽기
서버에 새 자료를 보내는 API를 시험할 때에는 먼저 해당 서비스의 테스트 환경과 권한을 확인하세요. 요청 방식에서 POST를 고른 다음 왼쪽 Body 탭의 Body type에서 JSON을 선택할 수 있습니다. 개발자 설명서에 따르면 JSON 유형에는 기본적으로 application/json Content-Type이 적용됩니다.
공식 세 번째 화면에는 POST 요청의 JSON 본문과 오른쪽 HTTP 400, 오류 메시지가 함께 나옵니다. 이처럼 전송 자체와 서버가 요청을 받아 처리한 결과는 구별해야 합니다. 본문 문법이나 필수 필드, 인증 조건이 API 문서와 다른지 먼저 살펴보세요.
요청 본문을 수정한 다음 같은 버튼으로 다시 보낼 수 있지만 POST는 서버 자료를 만들거나 바꿀 수 있습니다. 반복 요청해도 괜찮은 테스트 주소인지 확인한 뒤 실행하세요. GET과 달리 Body가 필요한지 여부는 해당 API의 계약을 따라야 하며, GET 연습에 무작정 JSON 본문을 붙이지 마세요.
응답 Body에 오류 이유가 있으면 상태 코드와 함께 기록하세요. 응답 헤더도 열어 서버가 어떤 형식으로 답했는지 확인할 수 있습니다. 같은 HTTP 400이라도 필요한 입력이 빠졌는지, 이미 존재하는 자료를 다시 만들려는 것인지 이유는 응답 내용과 서버 문서에 따라 달라집니다.
- 권한이 있는 테스트 환경의 POST URL과 필수 입력을 확인합니다.
- Body type을 JSON으로 고르고 필요한 본문을 넣어 보냅니다.
- 응답의 상태 코드와 오류 메시지를 함께 읽어 수정 지점을 찾습니다.
요청 저장과 전송 실패 시 확인할 점
자주 확인하는 요청은 상단 Save 버튼이나 Ctrl+S로 보관할 수 있습니다. 개발자 설명서는 .cartero 확장자의 TOML 텍스트 파일로 저장된다고 안내합니다. 나중에 Open 버튼 또는 Ctrl+O로 다시 열 수 있으므로 매번 URL과 헤더를 처음부터 작성하지 않아도 됩니다.
여러 요청을 저장한다면 파일 이름에 시험 환경과 용도를 적어 두세요. 다음에 열었을 때 운영 주소와 테스트 주소를 혼동하지 않는 데 도움이 됩니다. 저장한 요청을 다시 전송하기 전에도 URL과 방식이 지금 확인하려는 작업과 맞는지 한 번 더 살펴보세요.
다만 요청 파일에 남는 비밀값은 별도 문제입니다. Headers나 Variables의 화면 가리기 기능을 켰다고 저장 파일까지 암호화되는 것은 아닙니다. 저장하기 전 토큰과 암호가 들어 있는지 확인하고, 공유 저장소에 올릴 파일이라면 민감한 값을 제거하세요.
Send가 눌리지 않는다면 URL을 입력했는지 먼저 확인하세요. 요청이 실패하면 주소의 http 또는 https 시작 부분, 네트워크 연결, 서버 접근 권한을 차례로 살펴봅니다. 서버가 응답한 HTTP 오류와 연결 자체의 실패는 다르므로 오른쪽에 상태 코드가 있는지도 확인하세요.
화면이 공식 그림과 조금 다르더라도 GET·URL·Send와 왼쪽 요청 설정, 오른쪽 응답 영역의 관계를 기준으로 찾으면 됩니다. Flathub stable이 26.0에서 갱신될 수 있으니 실제 설치 화면의 버전과 개발자 문서 버전도 맞춰 보세요.
자주 묻는 질문
Cartero는 무료인가요?
공식 Flathub 목록에 Free로 표시되며 26.0 개발자 설명서가 Flathub Flatpak 배포를 공식 경로라고 명시합니다.
Linux에서 어떤 파일을 고르나요?
es.danirod.Cartero stable .flatpakref를 고르세요. Linux에 Flatpak과 Flathub가 준비돼 있어야 설치됩니다.
처음에는 어떤 요청을 보내면 되나요?
본인이 관리하거나 시험 권한이 있는 API의 GET URL을 입력하고 Send를 눌러 상태 코드와 Body를 확인하세요.
HTTP 400이면 Cartero가 고장 난 건가요?
공식 화면의 400은 예시 서버가 돌려준 응답입니다. 요청 본문과 서버의 오류 메시지, API 문서를 함께 확인하세요.
요청을 다시 쓸 수 있나요?
Save 또는 Ctrl+S로 .cartero 요청 파일을 저장하고 나중에 Open 또는 Ctrl+O로 열 수 있습니다. 저장 전 비밀값을 점검하세요.
요청을 보낸 뒤 실제 응답 내용까지 확인하세요
Cartero를 설치했다면 권한이 있는 GET 주소로 첫 요청을 보내고 상태 코드와 Body를 함께 보세요. 필요한 경우 Parameters나 Headers를 하나씩 바꾸어 결과를 비교할 수 있습니다. POST 같은 변경 요청은 테스트 환경에서만 사용하고 저장한 요청 파일에 비밀값이 남지 않았는지 확인하세요.
공식 자료와 확인일
Cartero 개발자 공식 다운로드 · Cartero 26.0 공식 설명서 · Flathub Cartero 무료 Linux 배포 · Cartero 26.0 공식 릴리스 | 2026-11-03
