APIFuseAPIFuse
문서서비스플레이그라운드상태
로그인회원가입

Service

차란 커머스

한국, 커머스베타
Playground에서 시험API 레퍼런스 열기

Overview

차란 커머스는 상품 목록 조회, 키워드 검색, 상품 상세 조회, 사용자 확인을 거친 옷장 정리 수거 신청을 정규화된 APIFuse 계약으로 제공합니다.

Status

정상

99.27%30일 가동률평균 응답1069ms

2026-09-262026-10-112026-10-25

Setup

Auth mode
Managed key
Credentials
  • charan scope가 허용된 managed key
Sandbox
미제공

APIs

행을 선택하면 해당 API의 레퍼런스로 이동합니다.

MethodAPIPathSummary
POST/v1/charan/get-item-detailFetches full details for one Charan item, including images, description, materials, colors, view count, and favorite count. Use when charan:list-items or charan:search-items returned an item_id and the user needs more than the summary. Do NOT use to discover items — use charan:list-items or charan:search-items instead. Returns item (normalized item detail).
POST/v1/charan/list-itemsBrowses current Charan secondhand fashion listings by page, category, or brand. Use when the user wants to browse inventory without a search keyword. Do NOT use for keyword search — use charan:search-items instead. Do NOT use for full product details — use charan:get-item-detail instead. Returns items (normalized item summaries) and summary (pagination information).
POST/v1/charan/request-closet-cleaningSubmits a real Charan closet-cleaning pickup request. Use only after the user explicitly confirms the request details; confirmed must be true. This sends the requester's name, phone number, address, bag count (1 to 5), and clothing kind (female, kg_selling, or accessory) to Charan so staff can arrange the pickup. Do NOT use for browsing or searching listings — use charan:list-items or charan:search-items instead. Returns closet_id, kind, bag_count, status, and message.
POST/v1/charan/search-itemsSearches Charan secondhand fashion listings by keyword with optional category, brand, size, price, color, and material filters. Use when the user has a search keyword. Do NOT use for browsing by category or brand alone without a keyword — use charan:list-items instead. Do NOT use for full product details — use charan:get-item-detail instead. Returns items (normalized item summaries) and summary (pagination information).

Related guides

  • sandbox key를 발급받고 첫 예약 생성까지 진행합니다.

  • 파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.

  • 예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.

  • 서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.

차란 상품 상세 조회
차란 상품 목록 조회
차란 옷장 정리 신청
차란 상품 검색
빠른 시작
Managed key
개요
에러 모델