GraphQL 요청에서 Query Name 표시하기

이 짧은 글에서는 GraphQL 요청의 QueryName을 표시하는 방법을 소개합니다.

1. 문제

GraphQL 요청의 Query Name은 Query URL에 나타나지 않으므로, 앱에서 어떤 요청인지 구분하기가 매우 어렵습니다.

이 문제는 Charles Proxy, Fiddler 같은 다른 웹 디버깅 프록시 도구에서도 똑같이 발생합니다.

이를 피하려면 본문(Body)을 열어 Query Name을 확인해야 합니다. 번거롭습니다.

2. GraphQL QueryName 표시하기

Proxyman은 GraphQL 개발자들이 겪는 이런 불편을 잘 알고 있어, 메인 테이블에 QueryName 열을 추가했습니다.

기본적으로 Proxyman은 GraphQL 요청인지 감지한 다음, QueryName을 추출해 표시합니다.

별도의 설정은 필요하지 않습니다.

3. 다음 단계

• 요청이나 응답의 특정 헤더를 사용해 열을 커스터마이즈하고 싶다면, Custom Column 기능으로 설정할 수 있습니다
• GraphQL 응답에 Map Local을 적용하고 싶다면 다음 글을 확인해 보세요: GraphQL 요청에 로컬 응답 매핑하는 방법?

팁: 앱 코드에서 모든 query와 mutation에 명확한 오퍼레이션 이름을 붙이세요. 익명 오퍼레이션은 쓸모 있는 이름 없이 표시될 수도 있습니다. 이름이 있다면, 테스트 중인 오퍼레이션에 대한 필터를 추가하고 상태 코드나 응답 본문 필터와 함께 사용해 실패를 빠르게 찾으세요.

---

Proxyman은 개발자가 iOS 기기, iOS 시뮬레이터, Android 기기에서 HTTPS 트래픽을 캡처할 수 있게 해 주는 고성능 macOS 앱입니다.

다음에서 받을 수 있습니다: https://proxyman.com