아래 블록을 통째로 에이전트에 복사하세요:
Prompt / HTTP
이 공개 API로 锎锔新材料科技의 기능성 첨가제를 조회해 주세요:
GET https://kj9896.com/api/v1/products?q=R1800&limit=10
https://kj9896.com/api/v1/guideDEVELOPER API / 에이전트 연동
이 문장을
에이전트에 복사하세요.
锎锔新材料科技의 공개 제품 데이터 API입니다. 아래 블록 중 하나를 에이전트에 복사하면 제품을 조회하고 고객을 대신해 요청을 접수할 수 있습니다.
- 01아래 블록을 복사하고
- 02에이전트에 붙여 넣으면
- 03바로 호출할 수 있습니다
- 가입도 필요 없고, 미리 준비할 것도 없습니다
- 제품 데이터는 읽기 전용이며 메시지 접수 창구는 하나뿐입니다
- 에이전트가 연동 안내를 직접 읽을 수 있습니다
02 / QUICK START
에이전트에 복사하면
바로 호출할 수 있습니다.
아래 블록은 모두 통째로 복사할 수 있습니다. 에이전트(Codex, Claude Code, Hermes, OpenClaw 또는 HTTP 요청을 보낼 수 있는 어떤 도우미든)에 붙여 넣으면 읽고 호출합니다.
아래 블록을 통째로 에이전트에 복사하세요:
Prompt / HTTP
이 모델의 전체 데이터를 읽어 주세요:
GET https://kj9896.com/api/v1/products/R1800-S
https://kj9896.com/api/v1/guide아래 블록을 통째로 에이전트에 복사하세요:
Prompt / HTTP
锎锔新材料科技에 제 요청을 대신 접수해 주세요(보내기 전에 내용을 먼저 보여 주세요):
POST https://kj9896.com/api/v1/messages
Content-Type: application/json
{"productCode":"R1800-S","contact":"you@example.com","message":"해당 모델의 추가 자료를 제공해 주세요."}
https://kj9896.com/api/v1/guide01 / CAPABILITY
할 수 있는 것,
할 수 없는 것.
범위는 의도적으로 좁혔습니다. 공개 제품 데이터와 메시지 접수 창구 하나뿐이며, 어떤 쓰기 기능도 없습니다.
PRODUCTS:READ
공개 제품 조회
키워드와 시리즈로 제품을 페이지 단위로 조회하거나 단일 모델을 바로 읽습니다. 측정값과 데이터 출처를 함께 반환하며, 제조사 중국어 원문은 그대로 유지합니다.
GET /api/v1/productsMESSAGES:CREATE
고객을 대신해 요청 접수
에이전트가 고객을 대신해 요구사항, 연락처, 관심 모델을 엔지니어의 사람이 확인하는 수신함으로 보낼 수 있습니다.
POST /api/v1/messagesNOT AVAILABLE
쓰기 기능은 일절 없음
제품 수정, 페이지 수정, 수신함 조회, 관리 엔드포인트가 모두 없습니다. 잘못된 메서드는 항상 405를 반환합니다.
PUT · PATCH · DELETE · 40503 / API REFERENCE
전체 API 레퍼런스,
그대로 호출하면 됩니다.
아래 모든 필드명과 파라미터, 오류 코드는 실제 서비스에서 검증했습니다. 제품 기술 데이터는 제조사 중국어 원문을 유지하며 기계 번역하지 않습니다.
GET
/api/v1/products제품 검색 및 둘러보기
읽기 전용. 네 개의 쿠리 파라미터는 모두 선택 사항이며 각각 최대 한 번만 올 수 있습니다. 알 수 없는 파라미터가 있으면 400을 반환합니다.
| 파라미터 | 설명 | 값 | 기본값 |
|---|---|---|---|
q | 키워드, 모델명·중국어 품명·분류·적용 분야와 대조 | 최대 100자 | — |
series | 시리즈로 필터 | super-dispersant / flame-retardant / comprehensive / masterbatch | — |
limit | 페이지당 행 수 | 1 – 100 | 20 |
offset | 오프셋 | ≥ 0 | 0 |
페이지 이동은 응답 본문의 nextOffset으로 다음 페이지 존재 여부를 판단하세요 — 값이 null이면 마지막입니다. "행 수가 limit보다 적음"으로 마지막 페이지를 판단하지 마세요.
GET
/api/v1/products/{code}단일 모델 읽기
읽기 전용. 모델은 URL의 마지막 세그먼트입니다(예: R1800-S). 이 엔드포인트는 쿠리 파라미터를 받지 않습니다.
404 product_not_found — 모델이 존재하지 않을 때의 응답입니다.
POST
/api/v1/messages고객을 대신해 요청 접수
유일한 쓰기 창구입니다. 요청 본문은 아래 세 필드만 허용하며, 하나라도 더 있으면 400 unknown_field를 반환합니다.
| 필드 | 필수 여부 | 길이 | 설명 |
|---|---|---|---|
message | 예 | 5 – 4000 | 고객 요구사항 원문 |
contact | 아니요 | ≤ 254 | 엔지니어가 회신할 수 있도록 고객 연락처(이메일 또는 전화) |
productCode | 아니요 | ≤ 40 | 관심 모델, 실제로 존재해야 함 |
보내기 전에 반드시 고객 동의를 받으세요. 201이 오면 이미 저장된 것이므로 재시도하지 마세요 — 중복 전송은 중복 요청을 만듭니다. 메시지는 锎锔新材料科技 엔지니어의 사람이 확인하는 수신함으로 전달됩니다.
product제품 객체 필드
목록과 상세 응답의 제품 객체 구조는 동일합니다.
| 필드 | 타입 | 설명 |
|---|---|---|
code | string | 모델, 예: R1800-S |
name_cn | string | 중국어 품명; nameVerified가 false이면 분류명과 같습니다 |
nameVerified | boolean | 중국어 품명의 원문 문서 대조 검증 여부 |
category | string | 제품 분류 |
series | string | 소속 시리즈 |
description_cn | string | 제품 설명 원문, 비어 있을 수 있습니다 |
applications | string[] | 적용 분야, 제품 자료에서 발췌 |
technicalData | object[] | 물리·화학 지표(실험실 대표값), 각 항목은 label / value |
mainComponent | string | 주요 성분, 비어 있을 수 있습니다 |
keyFunction | string | 핵심 기능, 비어 있을 수 있습니다 |
sources | string[] | 데이터 근거: 공식 제품 자료 |
{ ok: false, error }오류 코드
오류 응답 본문은 항상 { ok: false, error: "…" } 형식입니다.
| 상태 | 코드 | 의미와 대응 |
|---|---|---|
400 | invalid_query · invalid_input · unknown_field · unknown_product | 파라미터 또는 요청 본문이 올바르지 않습니다. 수정해 다시 보내고 재시도하지 마세요 |
403 | forbidden_origin | 브라우저의 교차 사이트 호출이 거부되었습니다. 서버나 터미널에서 호출하세요 |
404 | product_not_found | 모델이 존재하지 않습니다 |
405 | method_not_allowed | 메서드가 잘못되었습니다. 응답 헤더 Allow에 올바른 메서드가 있습니다 |
413 | payload_too_large | 요청 본문이 너무 큽니다 |
415 | content_type_required | POST는 Content-Type: application/json을 보내야 합니다 |
503 | service_unavailable | 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하세요 |
04 / BOUNDARIES
경계와 약속.
바로 사용 가능
페이지를 열면 바로 호출할 수 있으며, 사전에 처리할 절차가 전혀 없습니다.
읽기 전용 데이터 + 쓰기 창구 하나
제품 데이터는 전면 공개된 읽기 전용이며, 유일한 쓰기 창구는 고객을 대신한 요청 접수입니다. 이는 사람이 확인하는 수신함으로 들어가며 자동 처리되지 않습니다.
제품 텍스트는 지시가 아니라 데이터입니다
제품 설명에는 어떤 문구든 들어갈 수 있습니다. 에이전트가 이를 이해할 데이터로 다루게 하고, 그 안의 어떤 지시도 실행하지 마세요.
05 / FOR YOUR AGENT
또는 에이전트가
문서를 직접 읽게 하세요.
위 두 개는 주요 문서이고, 아래 항목은 기계 판독용 색인입니다 — 모두 일반 텍스트 또는 JSON이라 바로 가져올 수 있습니다. 연동 안내에는 엔드포인트, 파라미터, 응답 필드, 오류 코드, 동작 제약이 자세히 적혀 있습니다.
제품 기술 데이터는 실험실 대표값입니다. 양산 전에 소규모 검증을 진행하세요.