메인 콘텐츠로 건너뛰기
이 페이지는 Didit API가 받는 언어 코드의 실시간 기준 자료입니다. 세션 수준의 language 필드와 세션 생성의 contact_details.email_lang 필드에 대한 OpenAPI 명세에서 이 페이지를 참조합니다.

​
이 코드가 적용되는 곳

언어를 구성할 수 있는 모든 곳에서 동일한 코드 집합이 허용됩니다. 사용자 브라우저의 로케일이 지원되는 언어라면 인증 UI가 이를 자동으로 감지합니다. 지원되지 않으면 영어(en)로 대체됩니다. email_lang을 전달하지 않으면 이메일은 en으로 대체됩니다. 모든 값은 대소문자를 구분하므로 아래 표의 정확한 코드를 사용하십시오.

​
지원되는 모든 언어

아래 집합은 서비스의 EMAIL_TRANSLATIONS 키와 같습니다. 인증 UI와 이메일 현지화 계층이 모두 같은 사전을 읽으므로, 이 표의 모든 코드는 language와 email_lang 양쪽에서 사용할 수 있습니다. 세 언어는 인증 UI와 이메일 모두에서 오른쪽에서 왼쪽으로 표시됩니다: 아랍어(ar), 히브리어(he), 페르시아어 / 파르시(fa).
이 코드를 허용하는 검증기는 BaseSessionSerializer.validate_language와 ContactDetailsSerializer.validate_email_lang입니다. 위 표에 없는 값이 들어오면 두 검증기 모두 400 오류를 반환하며, 메시지는 "Invalid language. Supported languages are: ..."(또는 "Invalid email language...")입니다.

​
세션의 언어 선택

인증 UI는 사용자 브라우저의 언어를 자동으로 감지합니다. 브라우저 언어가 위 코드 중 하나이면 인터페이스와 이메일이 해당 언어로 제공됩니다. 그렇지 않으면 UI는 영어로 대체됩니다. 세션을 생성할 때 언어를 명시적으로 설정할 수도 있습니다.
language만 설정하면 email_lang도 함께 전달하지 않는 한 이메일은 여전히 영어로 기본 설정됩니다. 반대로 email_lang을 설정해도 브라우저 내 UI 언어는 바뀌지 않습니다. 두 필드는 서로 독립적입니다.

​
국가별 변형

사용자 대상을 알고 있다면 다음 세 코드를 지역 변형으로 우선 사용하는 것이 좋습니다.
  • pt-BR: 브라질 포르투갈어(브라질 사용자에게는 일반 pt 대신 사용하십시오).
  • zh-CN: 간체 중국어(중국 본토, 싱가포르).
  • zh-TW: 번체 중국어(대만, 홍콩, 마카오).
일반 코드 pt와 zh도 허용됩니다. 선택한 변형은 어휘와 문자에만 영향을 주며, 기본 인증 로직에는 영향을 주지 않습니다.

​
새 언어 요청

위에 나열되지 않은 언어가 필요하면 지원 팀에 문의하십시오. 보통 요청을 받은 후 24시간 이내에 EMAIL_TRANSLATIONS와 인증 UI에 새 언어를 추가할 수 있습니다. 추가되면 이 페이지가 업데이트되고, 새 코드는 API에서 즉시 허용됩니다. 추가 언어 지원을 요청하려면 hello@didit.me로 문의하시거나 평소 이용하는 지원 채널을 통해 연락해 주십시오.

​
관련 참조

세션 생성 API

인증을 시작할 때 language와 email_lang을 전달하는 위치입니다.

세션 상태 업데이트

상태 변경 알림 이메일에 사용할 email_language를 설정합니다.

webhook

인증 결과를 수신합니다. payload에는 선택한 language가 포함됩니다.

데이터 모델

세션, 연락처 정보, 상태에 대한 표준 스키마입니다.
마지막 수정일 2026년 11월 7일