DB 단건 등록

POST

/api/v1/leads

내부 POST /api/leads와 동일한 검증(상품·공급처 매핑, 필수 필드, 연락처·주민번호 형식, 공급처별 연락처 중복). providerId 필수. 등록자(createdBy)는 시스템 연동이므로 null. mohomId를 넣으면 동일 공급처·상품·mohom의 PENDING/IN_PROGRESS 주문이 있으면 그 주문에 확정 배정하고, 없으면 총량 100만 건 주문을 생성한 뒤 1건 확정 배정한다.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/json

Examples

Responses

🟢200

application/json

등록된 Lead

Bodyapplication/json

🟠400

🟠401

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://ldbds.kr/api/v1/leads' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "productId": "string",
    "providerId": "string",
    "mohomId": 0,
    "name": "string",
    "phone": "string",
    "email": "string",
    "region": "string",
    "address": "string",
    "memo": "string",
    "birth_date": "string",
    "gender": "M",
    "ssn": "string",
    "metadata": {
        "property1": null,
        "property2": null
    }
}'

Response Example

200 - Example 1

{
    "id": "string",
    "productId": "string",
    "providerId": "string",
    "status": "string",
    "name": "string",
    "phone_1": "string",
    "phone_3": "string",
    "email": "string",
    "region": "string",
    "address": "string",
    "birth_date": "string",
    "gender": "string",
    "createdAt": "2019-08-24T14:15:22.123Z",
    "product": {
        "id": "string",
        "name": "string"
    },
    "provider": {
        "id": "string",
        "name": "string"
    },
    "orderId": "string",
    "assignmentId": "string"
}

Modified at 2026-06-29 09:24:45

소유 DB 리스트

기분배 DB 리스트