Apidog Docs
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. 실시간 협업
  • Apidog 학습 센터
  • 시작하기
    • Apidog 소개
    • Apidog의 기본 개념
    • Apidog 탐색하기
    • 빠른 시작
      • 개요
      • 엔드포인트 생성하기
      • 요청 만들기
      • 어서션 추가하기
      • 테스트 시나리오 생성
      • API 문서 공유
      • 더 알아보기
    • Apidog로 마이그레이션
      • 개요
      • 수동 가져오기
      • 예약 가져오기(데이터 소스 바인딩)
      • 가져오기 옵션
      • 데이터 내보내기
      • 가져오기
        • Postman에서 가져오기
        • OpenAPI Spec 가져오기
        • cURL 가져오기
        • Markdown 가져오기
        • Insomnia에서 가져오기
        • apiDoc에서 가져오기
        • .har 파일 가져오기
        • WSDL 가져오기
  • Mock API 데이터
    • 개요
    • 스마트 목
    • 사용자 지정 목
    • 목 우선순위 순서
    • 목 스크립트
    • 클라우드 목
    • Self-Hosted Runner Mock
    • 목 언어(로케일)
  • 계정 및 환경설정
    • 계정 설정
    • OpenAPI 액세스 토큰 생성
    • 알림
    • 언어 설정
    • 단축키
    • 네트워크 프록시 구성
    • 데이터 백업
    • Apidog 업데이트
    • 계정 삭제
    • 실험적 기능
  • 요청 보내기
    • 개요
    • SSE 디버깅
    • MCP 클라이언트
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP 또는 WebService
    • GraphQL
    • gRPC
    • 디버깅에 요청 프록시 에이전트 사용
    • 요청 만들기
      • 요청 기록
      • 요청 기본 사항
      • 매개변수 및 본문
      • 요청 헤더
      • 요청 설정
      • 요청 디버그
      • 요청을 엔드포인트로 저장하기
      • HTTP/2
    • 인증 및 권한 부여
      • 개요
      • CA 및 클라이언트 인증서
      • 인증 유형
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Hawk 인증
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • 응답 및 쿠키
      • API 응답 보기
      • 쿠키 관리
      • 개요
  • API 개발 및 디버깅
    • 개요
    • 요청 생성
    • 요청 보내기
    • 디버깅 케이스
    • 테스트 케이스
    • 동적 값
    • 응답 검증
    • 디자인 우선 vs 요청 우선
    • 코드 생성
    • 환경 및 변수
      • 개요
      • 변수 사용하기
      • 환경 관리
    • Vault 시크릿
      • 개요
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • 동적 값 모듈
      • Airline
      • 동물
      • 색상
      • Commerce
      • Company
      • 데이터베이스
      • Datatype
      • 날짜
      • 금융
      • Food
      • Git
      • Hacker
      • Helpers
      • Image
      • Internet
      • Location
      • Lorem
      • 음악
      • Number
      • Person
      • Phone
      • 과학
      • String
      • System
      • Vehicle
      • Word
    • 사전/사후 프로세서
      • 개요
      • 어서션
      • 변수 추출
      • Wait
      • 보안
      • 데이터베이스 작업
        • 개요
        • MySQL
        • MongoDB
        • Redis
        • Oracle Client
      • 스크립트 사용
        • 개요
        • 전처리 스크립트
        • 사후 처리 스크립트
        • Public Scripts
        • Postman 스크립트 참조
        • 다른 프로그래밍 언어 호출하기
        • JS 라이브러리 사용하기
        • 응답 시각화
        • 스크립트 예제
          • 어서션 스크립트
          • 변수 사용하기
          • 요청 수정하기
          • 기타 예시
    • API 디버깅
      • AI Agent Debugger
      • A2A Debugger
  • API 설계
    • 개요
    • 새 API 프로젝트 생성
    • 엔드포인트 기본 사항
    • API 설계 지침
    • 모듈
    • 여러 요청 본문 예시 구성
    • 컴포넌트
    • 공통 필드
    • 전역 매개변수
    • 엔드포인트 변경 이력
    • 댓글
    • 엔드포인트 일괄 관리
    • 사용자 지정 프로토콜 API
    • Spec-first 모드(Beta)
    • 보안 스키마
      • 개요
      • 보안 스키마 생성
      • 보안 스키마 사용
      • 온라인 문서의 보안 스키마
    • 고급 기능
      • 사용자 지정 엔드포인트 필드
      • 연결된 테스트 시나리오
      • 엔드포인트 상태
      • 매개변수 목록의 표시 방식
      • 엔드포인트 고유 식별
    • 스키마
      • 개요
      • 새 스키마 생성
      • 스키마 구축
      • JSON 등에서 스키마 생성
      • oneOf, allOf, anyOf
      • Discriminator 사용하기
  • API 테스트
    • 개요
    • 테스트 시나리오
      • 테스트 시나리오 생성
      • 요청 간 데이터 전달
      • 흐름 제어 조건
      • 엔드포인트 및 엔드포인트 케이스에서 데이터 동기화
      • 다른 프로젝트에서 엔드포인트 및 엔드포인트 케이스 가져오기
      • 테스트 시나리오 내보내기
    • 테스트 보고서
      • 테스트 보고서
    • 테스트 시나리오 실행
      • 테스트 시나리오 실행
      • 테스트 시나리오 일괄 실행
      • 데이터 기반 테스트
      • 공유 테스트 데이터
      • 예약 작업
      • 다른 프로젝트의 API 런타임 환경 관리
    • 테스트 스위트
      • 개요
      • 테스트 스위트 생성
      • 테스트 스위트 오케스트레이션
      • 로컬에서 테스트 스위트 실행
      • CLI를 통해 테스트 스위트 실행
      • 예약 작업
    • API 테스트
      • 통합 테스트
      • 성능 테스트
      • 엔드투엔드 테스트
      • 회귀 테스트
      • 계약 테스트
    • Apidog CLI
      • 개요
      • Apidog CLI 설치 및 실행
      • Apidog CLI 옵션
    • CI/CD
      • 개요
      • Github Actions와 통합
      • Gitlab과 통합
      • Jenkins와 통합하기
      • Git 커밋으로 테스트 트리거하기
  • API 문서 게시
    • 개요
    • 지원되는 API 기술
    • Quick Share
    • API 문서 보기
    • Markdown 문서
    • 문서 사이트 게시
    • 사용자 지정 로그인 페이지
    • 사용자 지정 레이아웃
    • 사용자 지정 CSS, JavaScript, HTML
    • 사용자 지정 도메인
    • AI 기능
    • SEO 설정
    • 고급 설정
      • 문서 검색
      • CORS 프록시
      • Google Analytics 통합
      • 폴더 트리 설정
      • 가시성 설정
      • 문서 URL에 값 임베드하기
    • API 버전
      • 개요
      • API 버전 생성
      • API 버전 게시
      • API 버전별 엔드포인트 공유
  • 브랜치
    • 개요
    • 스프린트 브랜치 생성
    • 브랜치에서 API 테스트하기
    • 브랜치에서 API 설계하기
    • 스프린트 브랜치 병합
    • 스프린트 브랜치 관리
    • AI Branch(베타)
  • AI 기능
    • 개요
    • AI 기능 활성화
    • 테스트 케이스 생성
    • AI로 스키마 수정하기
    • 엔드포인트 규정 준수 검사
    • API 문서 완성도 검사
    • AI 기반 필드 명명
    • 자주 묻는 질문
  • Apidog MCP 서버
    • 개요
    • AI에 Apidog 프로젝트 연결
    • 게시된 문서를 AI에 연결하기
    • OpenAPI 파일을 AI에 연결하기
  • 모범 사례
    • API 서명 처리
    • OAuth 2.0으로 보호되는 API에 접근하기
    • 협업 워크플로
    • 인증 상태 관리
  • 오프라인 공간
    • 개요
  • Apidog Europe
    • Apidog Europe
  • 관리
    • 프로젝트 관리
      • 프로젝트 관리
      • 알림 설정
      • 프로젝트 멤버 관리
      • 프로젝트 리소스
        • 데이터베이스 연결
        • Git 연결
    • 팀 관리
      • 팀 관리
      • 팀 멤버 관리
      • 팀 활동
      • 팀 역할 및 권한
      • 팀 리소스
        • General Runner
        • 팀 변수
        • 요청 프록시 에이전트
      • 실시간 협업
        • 팀 협업
    • 온보딩 체크리스트
      • 기본 개념
      • 온보딩 가이드
    • 조직 관리
      • 조직 관리
      • 조직 역할 및 권한
      • 플랜 관리
        • 조직의 청구 관리자
      • Single Sign-On (SSO)
        • SSO 개요
        • Microsoft Entra ID 구성
        • Okta 구성하기
        • 조직에 대한 SSO 구성
        • 사용자 계정 관리
        • 그룹을 팀에 매핑하기
      • SCIM 프로비저닝
        • SCIM 프로비저닝 소개
        • Microsoft Entra ID
        • Okta
      • 조직 리소스
        • 셀프 호스팅 Runner
  • 청구
    • 개요
    • 크레딧
    • 플랜 업그레이드
    • 대체 결제 방법
    • 구독 관리
    • 유료 팀을 조직으로 이동하기
  • 애드온
    • API Hub
    • Apidog Intellij IDEA 플러그인
    • 브라우저 확장 프로그램
      • Chrome
      • Microsoft Edge
    • 요청 프록시
      • 웹에서의 요청 프록시
      • 공유 문서의 요청 프록시
      • 클라이언트의 요청 프록시
  • 데이터 및 보안
    • 데이터 저장 및 보안
    • 사용자 데이터 개인정보 보호 및 보안
    • 요청 라우팅 및 데이터 보안
  • 참조
    • API 설계 우선 접근 방식
    • Apidog OpenAPI 사양 확장
    • JSONPath
    • XPath
    • 정규 표현식
    • JSON Schema
    • CSV 파일 형식
    • Java 환경 설치
    • Runner 배포 환경
    • Apidog Markdown 구문
    • Apidog Swagger 확장
      • 개요
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Apidog JSON Schema 확장
      • 개요
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • 지원 센터
  1. 실시간 협업

팀 협업

다중 사용자 협업 및 실시간 동기화#

API 문서의 실시간 협업 기능은 R&D 팀의 업무 효율성을 향상하고 반복적인 커뮤니케이션 비용을 줄이는 데 도움이 됩니다. API 관리의 HTTP API 및 데이터 모델 모듈은 다중 사용자의 온라인 실시간 협업을 지원합니다. 다른 사용자가 데이터를 저장하면 현재 페이지는 다른 팀원이 변경한 내용을 자동으로 업데이트합니다.

적용 가능한 시나리오#

다음 시나리오에서는 수동으로 전체 새로 고침을 할 필요 없이 새 API 문서가 팀원에게 자동으로 동기화됩니다.
App 내에서 API를 수정하고 저장하는 경우
Swagger/OpenAPI 파일을 주기적으로 가져온 후

주요 특징#

Apidog의 다중 사용자 협업 기능은 다음을 포함합니다.
편집자 아바타를 실시간으로 표시하여 동일한 API를 편집 중인 사용자를 명확하게 보여줍니다.
필드 수준 협업을 통해 콘텐츠 충돌을 효과적으로 방지합니다.
충돌이 발생하는 경우 편집 중에 이를 확인할 수 있으므로 사전에 해결하고 편집을 계속할 수 있습니다.
세분화된 충돌 해결을 통해 양측의 일부 콘텐츠를 모두 보존할 수 있습니다.
API 문서에는 버전 기록과 휴지통이 있어 이전 버전으로의 롤백을 지원하므로 실수로 수정하는 것에 대해 걱정할 필요가 없습니다.
자동 가져오기 및 IDEA 플러그인도 실시간 협업의 일부이며, 가져오기 후 데이터가 자동으로 업데이트됩니다.

협업 링크#

"협업 링크" 기능을 사용하면 팀 구성원이 API를 빠르게 찾고 협업할 수 있습니다.
INFO
협업 링크는 팀 내부 공유에만 사용되며, 팀원이 아닌 사용자는 협업 링크를 열 수 없습니다.

협업 링크 복사#

API 오른쪽의 메뉴 모음에서 Copy Collaboration Link 버튼을 탭하여 협업 링크를 생성합니다. 이를 다른 팀원에게 보내고 링크를 열면 웹 터미널에서 해당 API로 직접 이동할 수 있습니다.

링크 URL 사양#

Apidog 링크는 여러 핵심 구성 요소로 이루어져 있습니다.
1.
프로젝트 ID
예: https://apidog.com/web/project/{Project-ID}
2.
프로젝트 내 지정된 엔드포인트
예: https://apidog.com/web/project/{Project-ID}/apis/api-{API-ID}
3.
엔드포인트 내 지정된 탭
예: https://apidog.com/web/project/{Project-ID}/apis/api-{API-ID}-run
이 URL 구조를 통해 사용자는 Apidog 플랫폼 내의 특정 프로젝트, API 및 보기에 접근할 수 있습니다.

URL에 매개변수 값 포함#

Apidog 엔드포인트를 공유할 때 기본 동작은 매개변수 값 없이 API 사양만 포함하는 것입니다. 그러나 특정 매개변수 또는 변수 값이 포함된 문서를 공유해야 하는 경우, 문서 URL에 직접 포함할 수 있습니다.

매개변수 값 전달#

URL에 매개변수 값을 포함하는 방법에는 단순 모드와 복합 모드, 두 가지가 있습니다. 단순 모드는 더 직관적이며 URL 인코딩이 필요하지 않지만, 대괄호 문자를 지원하지 않습니다. 복합 모드는 모든 문자를 지원하지만 매개변수 데이터를 인코딩해야 합니다.

단순 모드#

단순 모드에서는 query[xxx]=yyy 형식을 사용하여 xxx라는 이름의 매개변수에 yyy 값을 할당할 수 있습니다.
예:
https://apidog.com/web/project/406014/apis/api-10061199-run?query[aaa]=yyy&query[bbb]=yyy&path[aaa]=yyy&body[aaa]=yyy&header[aaa]=yyy&cookie[aaa]=yyy&environment[aaa]=yyy
매개변수 유형매개변수 값설명
쿼리 매개변수query[xxx]=yyy
경로 매개변수path[xxx]=yyy
본문 매개변수body[xxx]=yyyform-data 또는 x-www-urlencoded 본문 유형에 사용됩니다.
본문 매개변수body=yyy기타 본문 유형에 사용됩니다.
헤더 매개변수header[xxx]=yyy
쿠키 매개변수cookie[xxx]=yyy
환경 변수environment[xxx]=yyy기본 환경 변수에 저장됩니다.

복합 모드#

복합 모드에서는 JSON 객체를 인코딩하여 더 고급 매개변수 포함 기능을 사용할 수 있습니다. params 매개변수의 값은 다음 JSON 데이터에 encodeURIComponent를 호출하여 얻습니다.
{
    "query": [
        ["id", "value1"], 
        ["id", "value2"], 
        ["key2", "value3"]
    ],
    "path": [
        ["key1", "value1"], 
        ["key2", "value2"]
    ],
    "body": [
        ["aaa", "value1"], 
        ["key2", "value2"]
    ],
    "header": [
        ["testHeader", "value1"], 
        ["key2", "value2"]
    ], 
    "cookie": [
        ["testCookie", "value1"], 
        ["key2", "value2"]
    ], 
    "environment": [
        ["key1", "value1"], 
        ["key2", "value2"]
    ]
}
인코딩된 URL은 다음과 같습니다.
https://apidog.com/web/project/406014/apis/api-10061199-run?params={ "query"%3A{ "aaa"%3A"xxx"%2C "bbb"%3A"yyy" }%2C "body"%3A{ "aaa"%3A"xxx"%2C "bbb"%3A"yyy" }%2C "cookie"%3A{ "aaa"%3A"xxx"%2C "bbb"%3A"yyy" }%2C "environment"%3A{ "aaa"%3A"xxx"%2C "bbb"%3A"yyy" } }
매개변수 유형매개변수 값설명
쿼리 매개변수query
경로 매개변수path
본문 매개변수body본문 유형이 form-data 또는 x-www-urlencoded인 경우 body 값은 JSON입니다. 그렇지 않은 경우 body 값은 문자열입니다.
헤더 매개변수header
쿠키 매개변수cookie
환경 변수environment기본 환경 변수에 저장됩니다.

환경 변수 전달#

매개변수를 전달하여 URL을 통해 사용자의 "환경 변수"를 자동으로 설정할 수도 있습니다. 이를 위해 environment[variable name]=variable value 형식의 URL 매개변수를 추가하십시오.
예:
https://apidog.com/web/project/406014?environment[aaa]=xxx&environment[bbb]=yyy
https://apidog.com/web/project/406014/apis/api-10061199-run?environment[aaa]=xxx

여는 방식 변경#

협업 링크는 클라이언트와 웹 측 모두에서 열기를 지원합니다. 클라이언트를 통해 API를 찾으려면 Apidog Web으로 이동하여 Settings ⚙를 탭한 다음 General에서 Always open collaboration links on desktop 옵션을 켜십시오.
INFO
이 옵션은 Apidog Web에서만 사용할 수 있으며 Apidog Client에서는 사용할 수 없습니다.
협업 링크에 접근하면 클라이언트가 자동으로 호출됩니다.
Modified at 2026-06-09 08:53:32
Previous
요청 프록시 에이전트
Next
기본 개념
Built with