> ## Documentation Index > Fetch the complete documentation index at: https://docs.openapi.pluuug.com/llms.txt > Use this file to discover all available pages before exploring further. # 의뢰 생성 > 새 의뢰를 생성합니다. **자동 처리:** - `status` 미입력 시 기본 폴더의 기본 상태로 자동 할당 - 생성 직후 `InquiryStatusHistory` 1건 자동 생성 - `in_charge_set` 지정 시 알림 설정이 켜진 담당자에게 `MemberNotification` + 이메일/푸시 알림 발송 (비동기) - `inquiry_date` 미입력 시 오늘 날짜, `estimate` 미입력 시 0, `name` 미입력 시 '의뢰 제목' **파일 첨부:** `file_set`에 presigned API 응답의 `name`/`path`를 전달. 최대 30개. ### 커스텀 필드 * 플러그 Openapi는 의뢰의 커스텀 필드 값 수정을 지원합니다. * 커스텀 필드 자체의 수정은 비즈니스 설정 - 필드 설정 탭에서 수정하실 수 있습니다. * 수정 API의 `field_set` 필드를 활용하여 각 커스텀 필드의 값을 수정하실 수 있습니다. * 커스텀 필드는 총 8가지의 타입을 지원합니다. * 데이터 입력 예
데이터 타입 입력 예시
텍스트 (String) 
          
            \{
                "field": \{
                     "id": 1
                },
                "value": "text"
            }
숫자 (Number) * 소수점 입력 가능 
          
            \{
                "field": \{
                     "id": 2
                },
                "value": 12345
            }
멤버 (Member) * 해당 필드의 'member\_set'에서 id 선택 
          
            \{
                "field": \{
                     "id": 3
                },
                "value": \[
                    \{
                        "id": 1
                    },
                    \{
                        "id": 2
                    }
                ]
            }
날짜 (Date) 
          
            \{
                "field": \{
                     "id": 4
                },
                "value": "2025-03-01"
            }
시간 (Time) 
          
            \{
                "field": \{
                     "id": 5
                },
                "value": "10:00:00"
            }
토글 (Boolean) 
          
            \{
                "field": \{
                     "id": 6
                },
                "value": true
            }
단수선택 리스트 (Single List) * 해당 필드의 'option\_set'에서 id 선택 
          
            \{
                "field": \{
                     "id": 7
                },
                "value": \{
                    "id": "FEWKSLVE2"
                }
            }
복수선택 리스트 (Multi List) * 해당 필드의 'option\_set'에서 id 선택 
          
            \{
                "field": \{
                     "id": 8
                },
                "value": \[
                    \{
                        "id": "EFI4VLB2D"
                    },
                    \{
                        "id": "BORE32VKE"
                    }
                ]
            }
## OpenAPI ````yaml POST /v1/inquiry openapi: 3.1.0 info: title: pluuug openapi version: 1.0.0 description: >- 플러그에서 제공하는 REST API의 상세 내용을 확인하고 직접 테스트할 수 있는 인터페이스입니다.
이 문서를 통해 API의 엔드포인트, 요청 및 응답 형식 등을 확인할 수 있습니다. servers: - url: https://openapi.pluuug.com security: [] paths: /v1/inquiry: post: tags: - inquiry summary: 의뢰 생성 description: >- 새 의뢰를 생성합니다. **자동 처리:** - `status` 미입력 시 기본 폴더의 기본 상태로 자동 할당 - 생성 직후 `InquiryStatusHistory` 1건 자동 생성 - `in_charge_set` 지정 시 알림 설정이 켜진 담당자에게 `MemberNotification` + 이메일/푸시 알림 발송 (비동기) - `inquiry_date` 미입력 시 오늘 날짜, `estimate` 미입력 시 0, `name` 미입력 시 '의뢰 제목' **파일 첨부:** `file_set`에 presigned API 응답의 `name`/`path`를 전달. 최대 30개. operationId: inquiry_create requestBody: content: application/json: schema: $ref: '#/components/schemas/OpenapiInquiryListCreateRequest' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/OpenapiInquiryListCreateRequest' multipart/form-data: schema: $ref: '#/components/schemas/OpenapiInquiryListCreateRequest' responses: '201': content: application/json: schema: $ref: '#/components/schemas/OpenapiInquiryListCreate' description: '' '400': content: application/json: schema: $ref: '#/components/schemas/OpenapiInquiryListCreateValidationError' description: '' security: - ApiKeyAuth: [] Signature: [] components: schemas: OpenapiInquiryListCreateRequest: type: object properties: status: description: 의뢰 상태 (미입력 시 기본 폴더의 기본 상태) oneOf: - type: 'null' - $ref: '#/components/schemas/OpenapiNestedInquiryStatusRequest' client: description: 고객 oneOf: - type: 'null' - $ref: '#/components/schemas/OpenapiNestedClientRequest' contract: description: 계약 oneOf: - type: 'null' - $ref: '#/components/schemas/OpenapiNestedContractRequest' name: type: - string - 'null' minLength: 1 description: 의뢰 이름 (미입력 시 '의뢰 제목') maxLength: 64 content: type: - string - 'null' writeOnly: true minLength: 1 description: 의뢰 내용 estimate: type: - string - 'null' format: decimal pattern: ^-?\d{0,28}(?:\.\d{0,2})?$ description: 예상 견적 inquiryDate: type: - string - 'null' format: date description: 문의 일시 (미입력 시 오늘 날짜) funnel: writeOnly: true description: 유입 경로 oneOf: - type: 'null' - $ref: '#/components/schemas/OpenapiNestedInquiryFunnelRequest' workSet: type: - array - 'null' items: $ref: '#/components/schemas/OpenapiNestedInquiryWorkRequest' writeOnly: true description: 의뢰 업무 inChargeSet: type: - array - 'null' items: $ref: '#/components/schemas/OpenapiNestedMemberRequest' description: 영업 담당자 fieldSet: type: - array - 'null' items: $ref: '#/components/schemas/OpenapiInquiryFieldsRequest' writeOnly: true description: 커스텀 필드 fileLinkSet: type: - array - 'null' items: $ref: '#/components/schemas/OpenapiNestedInquiryFileLinkRequest' writeOnly: true description: 링크 첨부 fileSet: type: - array - 'null' items: $ref: '#/components/schemas/OpenapiNestedInquiryFileInputRequest' writeOnly: true description: 파일 첨부 (presigned API 응답의 path와 원본 파일명을 전달). 최대 30개. OpenapiInquiryListCreate: type: object properties: id: type: integer readOnly: true uniqueId: type: - string - 'null' readOnly: true description: 의뢰 고유번호 status: description: 의뢰 상태 (미입력 시 기본 폴더의 기본 상태) oneOf: - type: 'null' - $ref: '#/components/schemas/OpenapiNestedInquiryStatus' client: description: 고객 oneOf: - type: 'null' - $ref: '#/components/schemas/OpenapiNestedClient' contract: description: 계약 oneOf: - type: 'null' - $ref: '#/components/schemas/OpenapiNestedContract' name: type: - string - 'null' description: 의뢰 이름 (미입력 시 '의뢰 제목') maxLength: 64 estimate: type: - string - 'null' format: decimal pattern: ^-?\d{0,28}(?:\.\d{0,2})?$ description: 예상 견적 inquiryDate: type: - string - 'null' format: date description: 문의 일시 (미입력 시 오늘 날짜) created: type: string format: date-time readOnly: true description: 생성일시 inChargeSet: type: - array - 'null' items: $ref: '#/components/schemas/OpenapiNestedMember' description: 영업 담당자 required: - created - id - uniqueId OpenapiInquiryListCreateValidationError: type: object properties: nonField: type: array items: type: string status: $ref: '#/components/schemas/OpenapiNestedInquiryStatusValidationError' client: $ref: '#/components/schemas/OpenapiNestedClientValidationError' contract: $ref: '#/components/schemas/OpenapiNestedContractValidationError' name: type: array items: type: string content: type: array items: type: string estimate: type: array items: type: string inquiryDate: type: array items: type: string funnel: $ref: '#/components/schemas/OpenapiNestedInquiryFunnelValidationError' workSet: type: array items: type: string inChargeSet: type: array items: type: string fieldSet: type: array items: type: string fileLinkSet: type: array items: type: string fileSet: type: array items: type: string OpenapiNestedInquiryStatusRequest: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: id: type: integer required: - id OpenapiNestedClientRequest: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: id: type: integer required: - id OpenapiNestedContractRequest: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: id: type: integer required: - id OpenapiNestedInquiryFunnelRequest: type: object properties: utmCampaign: type: - string - 'null' description: UTM Campaign utmSource: type: - string - 'null' description: UTM Source utmMedium: type: - string - 'null' description: UTM Medium utmContent: type: - string - 'null' description: UTM Content utmTerm: type: - string - 'null' description: UTM Term guestUid: type: - string - 'null' description: Guest UID gclid: type: - string - 'null' description: Google Click ID OpenapiNestedInquiryWorkRequest: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: name: type: string minLength: 1 maxLength: 64 required: - name OpenapiNestedMemberRequest: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: id: type: integer required: - id OpenapiInquiryFieldsRequest: type: object properties: field: allOf: - $ref: '#/components/schemas/OpenapiNestedFieldRequest' description: 커스텀 필드 value: anyOf: - type: string - type: number - type: boolean - type: object - type: array items: type: object description: 값 required: - field - value OpenapiNestedInquiryFileLinkRequest: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: text: type: string minLength: 1 description: 표기 텍스트 maxLength: 1024 link: type: string format: uri minLength: 1 description: 링크 URL maxLength: 2048 required: - link - text OpenapiNestedInquiryFileInputRequest: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: name: type: string minLength: 1 description: 파일명 maxLength: 512 file: type: string minLength: 1 description: S3 object key (presigned 응답의 path) maxLength: 1024 required: - file - name OpenapiNestedInquiryStatus: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: id: type: integer title: type: string readOnly: true folder: allOf: - $ref: '#/components/schemas/OpenapiNestedFolder' readOnly: true required: - folder - id - title OpenapiNestedClient: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: id: type: integer status: readOnly: true description: 고객 상태 oneOf: - type: 'null' - $ref: '#/components/schemas/OpenapiNestedClientStatus' companyName: type: string readOnly: true description: 회사명 inCharge: type: - string - 'null' readOnly: true description: 담당자 position: type: - string - 'null' readOnly: true description: 직책 contact: type: - string - 'null' readOnly: true description: 연락처 email: type: - string - 'null' format: email readOnly: true description: 이메일 required: - companyName - contact - email - id - inCharge - position - status OpenapiNestedContract: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: id: type: integer title: type: string readOnly: true description: 계약 제목 amount: type: integer readOnly: true description: 계약 금액 type: enum: - I - S - G type: string x-spec-enum-id: 4b039ce324ed7b8c readOnly: true description: |- 계약 타입 * `I` - 회차 정산형 * `S` - 정기 결제형 * `G` - 단건 정산 x-enumNames: - 회차 정산형 - 정기 결제형 - 단건 정산 status: enum: - P - I - C - T type: string x-spec-enum-id: 81c3becab4b92e5c readOnly: true description: |- 계약 상태 * `P` - 계약 준비 중 * `I` - 정산 진행 중 * `C` - 계약 종료 * `T` - 계약 중단 x-enumNames: - 계약 준비 중 - 정산 진행 중 - 계약 종료 - 계약 중단 startDate: type: - string - 'null' format: date readOnly: true description: 계약 착수일 endDate: type: - string - 'null' format: date readOnly: true description: 계약 종료일 required: - amount - endDate - id - startDate - status - title - type OpenapiNestedMember: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: id: type: integer nickname: type: - string - 'null' readOnly: true description: 닉네임 email: type: string readOnly: true description: 이메일 isActive: type: boolean readOnly: true description: 활성화 여부 grade: allOf: - $ref: '#/components/schemas/OpenapiNestedMemberGrade' readOnly: true description: 등급 required: - email - grade - id - isActive - nickname OpenapiNestedInquiryStatusValidationError: type: object properties: id: type: array items: type: string OpenapiNestedClientValidationError: type: object properties: id: type: array items: type: string OpenapiNestedContractValidationError: type: object properties: id: type: array items: type: string OpenapiNestedInquiryFunnelValidationError: type: object properties: utmCampaign: type: array items: type: string utmSource: type: array items: type: string utmMedium: type: array items: type: string utmContent: type: array items: type: string utmTerm: type: array items: type: string guestUid: type: array items: type: string gclid: type: array items: type: string OpenapiNestedFieldRequest: type: object properties: id: type: integer required: - id OpenapiNestedFolder: type: object properties: id: type: integer name: type: string readOnly: true required: - id - name OpenapiNestedClientStatus: type: object description: |- nested 아이템이 제공되면 선언된 required 필드를 모두 가져야 함을 강제한다. 부모 레벨 partial(미전송 필드 생략)은 유지하되, nested 아이템은 object-level validate에서 required 필드 존재를 재확인해 누락 시 400을 반환한다. properties: id: type: integer title: type: string readOnly: true description: 상태 제목 required: - id - title OpenapiNestedMemberGrade: type: object properties: id: type: integer readOnly: true title: type: string readOnly: true required: - id - title securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key Signature: type: apiKey in: header name: X-Signature description: |- HMAC-SHA256 방식으로 body를 secret key로 해싱하여 생성한 서명을 넣어야 합니다. 서버는 X-API-Key와 대응되는 secret key로 서명을 검증합니다. ````