2주 후 API 업데이트
7 5월 2025, 10:00
2주 후, 5월 24일 주말 동안 새로운 EasyWebshop API가 구현될 예정입니다. 기술적인 배경 지식이 부족하신 고객분들을 위해 설명드리자면, API는 귀사의 웹샵을 결제 서비스 제공업체, 배송 서비스 및 사무용 애플리케이션과 같은 외부 플랫폼에 연결하는 역할을 합니다. 또한, 맞춤형 보고서 생성, 실시간 고객 승인 또는 거부, 로컬 애플리케이션과의 판매 및 재고 동기화 기능을 제공합니다.
일반적인 관행 및 업계 표준과의 호환성 덕분에, 경우에 따라 AI 생성 코드의 도움을 받아 새로운 API 연결을 훨씬 더 쉽게 생성할 수 있게 됩니다. 이를 통해 자체적으로 맞춤형 연결을 구축하고자 하는 중소기업의 주요 재정적 장벽이 해소될 것입니다.
2025년 6월 21일에 시작하여 저희가 세 번째로 주최하는 웹 디자인의 여름(Summer of web design) 기간 동안에도 숙련된 웹 개발자를 계속 고용하실 수 있습니다.
API 변경 사항
현재 API를 사용하고 계신 경우, 연결을 약간 업데이트하셔야 합니다. API를 사용하지 않으신다면, 이 기술적인 부분은 건너뛰셔도 괜찮습니다.
- 토큰 인증
- 새로운 API가 구현되면 API 설정에서 토큰을 생성하고 권한을 설정한 후, Authorization 헤더 방식을 "Basic"에서 "Bearer YOUR_API_TOKEN"으로 변경하시기를 권장합니다. 관리자 계정을 통한 Basic 인증은 계속 지원되지만, 올해 말까지 단계적으로 중단될 예정입니다. 주 계정의 이메일 주소와 비밀번호를 이용한 인증은 더 이상 지원되지 않습니다.
- 기본값을 JSON으로
- 2012년에 현재 API가 출시되었을 때는 XML 형식이 기본으로 선택되었습니다. 새로운 API는 JSON을 기본으로 사용하지만, URL에 "?format=xml" 쿼리 문자열을 추가하여 XML로 계속 전환할 수 있습니다.
- 표준 JSON-LD 스키마와의 호환성
- 제품 정보는 가능한 경우 schema.org/Product 표준을 따릅니다. 가장 중요한 변경 사항은 "product_code"가 "productID"로 변경되는 것입니다. 주문 정보는 schema.org/Order 표준을 따릅니다. 여기서 가장 중요한 변경 사항은 "order_code"가 "orderNumber"로 변경되는 것입니다.
- 간소화된 API 엔트리 포인트
- "productlist"와 같은 엔트리 포인트는 더 이상 작동하지 않습니다. 유효한 네 가지 엔트리 포인트는 "category", "product", "customer", "order"입니다.
- 제품 사진 업로드
- 더 이상 사진 업로드를 위한 별도의 메서드가 제공되지 않습니다. 이 과정이 간소화되어, 제품 삽입 및 업데이트 시 사진을 첨부할 수 있게 되었습니다.
- 카테고리명, 제품명 및 설명
- 웹샵에서 해당 언어가 활성화되어 있지 않더라도, 모든 지원 언어로 카테고리명, 제품명 및 설명을 삽입하고 업데이트할 수 있습니다.
- API Push 구조 소폭 변경
- API Push는 고객 및 주문 정보를 실시간으로 전송하는 데 사용됩니다. 변경된 구조는 schema.org/Person 및 schema.org/Order와의 호환성이 향상됩니다.
- API 연결 생성 관련 문서 보강
- 결제 서비스 제공업체, 배송 서비스 및 사무용 애플리케이션 연결이 훨씬 용이해집니다. 새로운 문서에서는 이러한 연결을 신속하게 설정하기 위한 광범위한 예시를 제공할 예정입니다.
새로운 API에 대한 자세한 내용은 20개 전체 언어로 API 문서 페이지에 게시될 예정입니다. 구현이 진행되는 주말 동안 저희 지원팀이 기존 구현 변경에 대한 신속한 지원을 제공해 드릴 것입니다.