Skip to main content
POST
/
v1
/
inquiry
의뢰 생성
curl --request POST \
  --url https://openapi.pluuug.com/v1/inquiry \
  --header 'Content-Type: application/json' \
  --data '{
  "status": {
    "id": 123
  },
  "client": {
    "id": 123
  },
  "contract": {
    "id": 123
  },
  "name": "<string>",
  "content": "<string>",
  "estimate": "<string>",
  "inquiryDate": "2023-12-25",
  "funnel": {
    "utmCampaign": "<string>",
    "utmSource": "<string>",
    "utmMedium": "<string>",
    "utmContent": "<string>",
    "utmTerm": "<string>",
    "guestUid": "<string>",
    "gclid": "<string>"
  },
  "workSet": [
    {
      "name": "<string>"
    }
  ],
  "inChargeSet": [
    {
      "id": 123
    }
  ],
  "fieldSet": [
    {
      "field": {
        "id": 123
      },
      "value": "<string>"
    }
  ]
}'
{
  "id": 123,
  "status": {
    "id": 123,
    "title": "<string>",
    "folder": {
      "id": 123,
      "name": "<string>"
    }
  },
  "client": {
    "id": 123,
    "status": {
      "id": 123,
      "title": "<string>"
    },
    "companyName": "<string>",
    "inCharge": "<string>",
    "position": "<string>",
    "contact": "<string>",
    "email": "jsmith@example.com"
  },
  "contract": {
    "id": 123,
    "title": "<string>",
    "amount": 123,
    "type": "I",
    "status": "P",
    "startDate": "2023-12-25",
    "endDate": "2023-12-25"
  },
  "name": "<string>",
  "estimate": "<string>",
  "inquiryDate": "2023-12-25"
}

커스텀 필드

  • 플러그 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”
        }
    ]
}

Authorizations

X-API-Key
string
header
required

Body

status
object
required

의뢰 상태

client
object | null
required

고객

contract
object | null
required

계약

name
string
required

의뢰 이름

Required string length: 1 - 64
content
string | null
required

의뢰 내용

Minimum length: 1
estimate
string<decimal> | null
required

예상 견적

inquiryDate
string<date>
required

문의 일시

workSet
object[] | null
required

의뢰 업무

inChargeSet
object[] | null
required

영업 담당자

fieldSet
object[] | null
required

커스텀 필드

funnel
object

유입 경로

Response

id
integer
required
status
object
required

의뢰 상태

client
object
required

고객

contract
object
required

계약

name
string
required

의뢰 이름

Maximum length: 64
estimate
string<decimal> | null
required

예상 견적

inquiryDate
string<date>
required

문의 일시

I