뉴스옥션 보도자료 주문 API

시작하기

뉴스옥션 보도자료 주문 API를 우리 시스템에 연결해 줘.
설명서: https://news-auction.com/api/v1/llms.txt (이 문서를 먼저 끝까지 읽고 그대로 따를 것)
API 키는 환경 변수 NEWSAUCTION_API_KEY 에서 읽어.
할 일: 매체 목록과 가격 불러오기, 신청 보내기(client_ref 로 중복 방지), 상태 확인해서 기사 주소 저장하기, 오류 메시지 사용자에게 보여 주기.

1. 회원가입·포인트 충전
   뉴스옥션에 가입하고 사이트에서 포인트를 충전합니다(무통장 입금). 신청 금액은 이 포인트에서 차감됩니다(1P = 1원, 부가세 별도). API로는 충전이나 카드 결제를 할 수 없습니다.
2. API 키 만들기
   로그인하면 이 페이지에서 바로 받을 수 있습니다. 회사 계정이면 대표 계정으로 받아 주세요. 키는 받을 때 한 번만 보입니다.
3. 매체 목록 받기
   action=media 로 신청할 수 있는 매체와 귀사 가격을 받습니다.
4. 신청하기
   action=order 로 원고와 매체를 보냅니다. 바로 포인트가 차감되고 신청번호가 돌아옵니다.
5. 진행 확인
   action=status 로 송출 여부와 기사 주소를 확인합니다.

인증

모든 요청은 HTTPS 로 보내고, 요청 머리에 발급받은 키를 넣습니다.

Authorization: Bearer na_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

계정·잔액

계정과 남은 포인트를 알려 줍니다.

{"ok": true, "data": {"member": "company_id", "name": "회사명", "point": 1250000}}

매체 목록

지금 신청할 수 있는 매체와 귀사 가격입니다. 매체 상태와 가격은 바뀔 수 있으니 신청 전에 새로 받아 쓰는 걸 권합니다.

{"ok": true, "data": {"count": 124, "media": [
  {"id": "1558507769", "name": "ABC뉴스", "category_id": "10", "category": "일반", "price": 35000,
   "portal": {"naver": true, "daum": true, "google": true},
   "named": true, "cp": false, "deadline": "16:00", "avg_time": "02:00"}
]}}

신청

JSON(Content-Type: application/json)으로 보내거나, 파일을 붙일 때는 multipart 로 보냅니다.

curl -X POST 'https://news-auction.com/api/v1/press.php?action=order' \
  -H 'Authorization: Bearer na_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_ref": "PK-20261019-001",
    "title": "기사 제목",
    "content": "본문 ...",
    "media": ["1558507769", "1589249255"],
    "keywords": ["대표키워드", "보조키워드"],
    "images": ["https://example.com/photo.jpg"]
  }'

파일을 붙일 때(multipart)

curl -X POST 'https://news-auction.com/api/v1/press.php?action=order' \
  -H 'Authorization: Bearer na_...' \
  -F client_ref=PK-20261019-002 -F 'title=기사 제목' -F 'content=본문 ...' \
  -F media=1558507769 -F media=1589249255 \
  -F 'images[]=@photo1.jpg' -F 'source=@release.hwp'

성공 응답(201)

{"ok": true, "data": {"duplicate": false, "order_ids": ["2610190001", "2610190002"],
  "total": 95000, "point_left": 1155000, "deadline_note": ""}}

• 매체마다 신청번호가 하나씩 생깁니다(order_ids).
• 신청 금액(total)이 바로 포인트에서 차감됩니다. 포인트가 모자라면 아무것도 만들지 않고 거절합니다(402).
• deadline_note 가 있으면 당일 마감이 지나 다음 영업일에 처리된다는 안내입니다.
• 같은 client_ref 로 다시 보내면 "duplicate": true 와 처음 신청번호가 돌아옵니다(200).

상태 조회

{"ok": true, "data": {"orders": [
  {"order_id": "2610190001", "media_id": "1558507769", "media": "ABC뉴스",
   "status": "published", "status_label": "완료", "price": 35000,
   "article_url": "https://...", "ordered_at": "2026-10-19 13:37:06", "reserve": ""}
]}}

한 번에 100건까지 조회됩니다. 진행 알림은 상태 조회로 확인해 주세요. 몇 분에 한 번 정도면 충분합니다.

오류 코드

권장 흐름

1. 하루 한 번이나 신청 직전에 media 를 받아 매체 번호·가격을 맞춥니다.
2. 신청 전에 account 로 포인트를 확인합니다.
3. order 를 보낼 때 client_ref 에 귀사 주문번호를 넣습니다. 응답을 못 받았으면 같은 값으로 다시 보내면 됩니다.
4. status 를 몇 분 간격으로 불러 published 가 되면 article_url 을 귀사 고객에게 전달합니다.

자주 묻는 질문

가격은 어떻게 정해지나요?

사이트에서 같은 계정으로 신청할 때와 같은 가격입니다. 매체별 가격은 media 응답의 price 로 확인해 주세요.

API로 결제나 충전도 되나요?

안 됩니다. API 신청은 미리 충전해 둔 포인트에서만 차감되고, 카드 결제나 충전 기능은 없습니다. 포인트 충전은 뉴스옥션 사이트의 포인트 충전(무통장 입금)으로 해 주세요.

반려되면 포인트는 어떻게 되나요?

사이트에서 신청한 것과 같은 규칙으로 처리됩니다. 반려되면 status 가 rejected 로 바뀌고, 대체 매체나 환불은 담당자가 안내드립니다.

직원마다 키를 따로 받을 수 있나요?

아니요. 키는 회사 대표 계정에 하나만 있습니다. 여러 시스템에서 같은 키를 쓰고, 새로 받으면 예전 키는 바로 멈춥니다.

시험해 볼 수 있나요?

실제 신청이 들어가므로 처음에는 저렴한 매체 하나로 시험하고, 담당자에게 시험 건이라고 알려 주시면 취소·환불해 드립니다.