타입·provider·오류 확인

호출 전 타입부터 확인하기

서비스 이름만 알아서는 코드를 작성할 수 없습니다. 메서드가 어떤 값을 받고 어떤 값을 돌려주는지, 비어 있는 값이나 실패를 어떻게 표현하는지 확인해야 합니다.

계약에서 확인할 것	읽는 방법
입력 타입과 필수 조건	문자열·숫자·객체 중 무엇인지, 생략하거나 빈 값을 전달할 수 있는지 확인
반환 타입과 완료 시점	결과를 즉시 받는지 기다려야 하는지, 요청 접수와 작업 완료가 어떻게 다른지 확인
오류와 진단	빌드·실행·provider 단계 중 어디에서 실패했는지 확인
목표 플랫폼	선언·변환·빌드·실행 중 어떤 단계까지 확인되었는지 확인
예제의 기준	메타데이터 버전·원본·hash·검증 환경이 해당 API와 맞는지 확인

예를 들어 파일 전송에서는 “전송 요청이 받아들여짐”과 “상대편이 같은 파일을 받음”을 구분해야 합니다. 어떤 반환값이 어느 상태를 뜻하는지는 실제 계약이 정합니다. 메일·저장·인증·결제도 같은 방식으로 결과의 의미를 읽습니다.

provider와 목표 플랫폼 선택하기

provider는 해당 기능을 수행하는 구체적인 서비스 연결 방식입니다. 목표 플랫폼은 코드가 생성되고 실행되는 환경입니다. 두 선택의 지원 상태를 각각 확인하세요.

제품 미리보기에서는 Market이 진입·상품 검증 정보를 제공하고 SaaS가 실행 환경과 provider를 맡는 설계입니다. Unibase의 export·generator·SDK는 특정 host에 종속되지 않는 것이 목표입니다. 이 역할 구분은 새 provider의 지원이나 연결 완료를 뜻하지 않습니다. 연결 계약의 미완료 범위를 확인하세요.

타입 선언이 있더라도 해당 플랫폼의 변환 코드나 provider 구현이 준비되지 않았을 수 있습니다. 코드 생성 성공, 생성 코드의 빌드 성공, 실제 서비스 처리 성공도 서로 다른 근거입니다. 새 라이브러리의 지원표는 생산자의 계약과 검증 결과를 받은 뒤 제공하며 현재 모든 언어·플랫폼 지원을 보장하지 않습니다.

메일 provider를 선택하는 학습 과제라면 다음을 순서대로 확인합니다.

목표 플랫폼에서 해당 API와 provider를 지원하는지 확인합니다.
미리보기와 운영에서 사용할 연결이 어떻게 구분되는지 확인합니다.
입력·결과·실패 타입과 등록 예제를 함께 읽습니다.
검증된 환경에서 관측한 결과가 자신의 목표를 충족하는지 비교합니다.

mail의 provider와 정확한 profile 필드는 실제 공통 정의에 있습니다. 실메일 provider·운영 인증값 입력 절차는 아직 제공하지 않습니다. 운영의 비밀값을 문서 예제나 AI 대화에 넣지 않습니다.

실패한 단계 찾기

관측한 상황	먼저 확인할 것
의미 검사에서 중단	호출 이름, 인수·반환 타입, 필수 입력과 진단 위치
변환할 수 없음	선택한 플랫폼과 해당 기능의 생산자 지원 상태
생성 코드 빌드 실패	생성 기준 버전, 의존성과 실제 빌드 진단
provider 처리 실패	실제 연결 환경, 계약의 오류 상태와 해당 요청 결과
정상 응답인데 화면은 실패	원래 응답과 화면 표시를 비교하고 UI 결함인지 확인

새 서비스의 오류 코드나 재시도·취소·timeout 규칙은 확인한 계약대로 설명합니다. 특히 결제처럼 반복 요청의 결과가 중요한 작업은 실패 안내만 보고 성공 여부를 추정하지 말고 거래 상태의 근거를 확인해야 합니다. 이 초안은 새 API의 중복 처리 방지 기능을 보장하지 않습니다.

현재 native 실행 경로는 사용자 throw·try/catch를 지원하지 않는 제한이 있습니다. 새 서비스 예제를 임의의 catch 코드로 감싸 실행 가능하다고 안내하지 않습니다. 오류와 예외에서 선언·미지원 빌드 진단·실행 실패를 구분하고, 새 provider의 오류 전달 방식은 확정 계약을 따릅니다.

다음은 미리보기와 운영 연결입니다.