Truthound · API 변경과 데이터 계약
공식 API 변경에 맞춰 소비자의 필드·상태 계약을 점검합니다.
18 편
Java ProtoJSON extension: short name 대신 승인한 qualified key 확인하기
extension의 완전한 정체성과 짧은 표시 이름을 구별해야 한다. 소비자가 해석할 qualified JSON key를 승인한 뒤 출력한다.
문자열 Zarr 오류 보고의 버전 정정부터 보관 시험에 반영하기
오래된 버전의 오류를 최신 지원 범위로 확대하지 않는다. 실제 설치 조합의 문자열 좌표 왕복으로 승인한다.
Delta location 문제의 정정: Unity Catalog URI 계약부터 맞춘다
퍼센트가 든 location은 URI text와 저장 key의 서로 다른 표현을 구분해 검사한다. 후속 정정에 따라 UC의 수신·반환 경계를 조사하고 철회된 Delta 수정안을 해결책으로 반복하지 않는다.
Shopify 다중 운송장 이관: trackingNumber가 배열을 가리는 경우
복수 운송장 기능을 켜도 옛 단수 필드가 요청에 남아 있으면 일부 번호를 잃을 수 있다.
Shopify selling_plan_id 검증: 일반 구매의 null을 누락으로 세지 않기
새 webhook 필드는 구독 품목의 판매 계획을 전달한다. 일반 구매까지 필수값 규칙을 적용하면 정상 데이터가 실패한다.
Shopify 반품 배송비 세금: 확정 전 null과 확정된 0을 구별하기
예상 세금과 확정 세금은 계산 시점이 다르다. 정산에서는 값뿐 아니라 확정 여부를 보존해야 한다.
Shopify 재고 재활성화: 생략한 수량과 0으로 지정한 수량 구별하기
재활성화 API의 기본 동작이 바뀌면, 이전 수량을 초기화하던 업무 가정도 함께 점검해야 한다.
Shopify FULFILLMENT_NOT_REQUIRED: 미출고와 출고 의무 없음을 구별하기
새 이행 상태를 단순한 미출고로 매핑하면, 처리할 수량이 없는 주문이 작업 큐에 남는다.
Shopify Metaobject values 수정: 생략한 필드를 유지하는 패치와의 차이
values의 편리한 직렬화 뒤에는 생략 필드를 지우는 수정 의미가 있다. 유지 의도를 별도 계약으로 남긴다.
Shopify 마켓 관계 수집: 버전이 바뀌면 페이지 커서를 재시작해야 하는 이유
관계 ID가 유지되어도 재구축 중 커서는 달라질 수 있다. 수집 세대를 나누어 혼합 목록의 인수를 막는다.
Shopify 주문 취소 인계: job 접수와 jobResult의 완료 근거 분리하기
비동기 취소 요청의 접수는 고객에게 완료를 안내할 증거가 아니다. 취소 전용 결과를 확인할 경계를 둔다.
Shopify 복수 바코드 수정: 추가 요청처럼 보이는 전체 집합 교체
새 barcodes 입력에 추가할 값만 보내면 기존 식별자가 사라질 수 있다. 전체 목록과 첫 항목의 호환성을 따로 확인한다.
Shopify metafield 필터 오류: 빈 성공 결과로 숨기지 않기
새 필터의 실패는 실제 결과 없음과 다르므로 응답 상태와 자료 집합을 함께 시험해야 한다.
Shopify legalEntityId: 같은 null을 같은 법인으로 묶지 않기
상점별 ID와 조직 법인 ID를 구분하고 null을 하나의 법인으로 합치지 않아야 새로운 통합 집계를 시험할 수 있다.
Shopify 기프트카드 통화 정책: 생성 조합과 환산 전략 대사
다중 통화 실험은 금액 숫자보다 생성 시 확정되는 통화·사용 정책의 조합부터 확인해야 한다.
Shopify 마케팅 누적값에서 증분으로 이전: 같은 성과를 다시 더하지 않기
모드 이름만 바꾸면 누적값이 증분으로 더해질 수 있으므로 전환 경계의 기준 누적값과 새 증분을 연결해야 한다.
Shopify DraftOrderLineItem grams에서 weight로: value와 unit 함께 이전
필드 이름 이전은 단위 계약 이전이므로 새 숫자와 단위를 함께 정규화한 뒤 기존 업무 무게와 비교해야 한다.
Shopify 입고 취소 수량: received 합계와 실제 재고 구별
새 입고 상태를 시험할 때 received를 물리적으로 도착한 수량으로 읽지 않도록 상태별 합계를 분리해야 한다.
