빠른 시작

1. 회원 가입 및 프로젝트 생성

가장 먼저 MOAI Console에서 계정을 생성해야 합니다. 이메일 인증 후 로그인을 하면 대시보드로 이동하게 됩니다. 대시보드에서 'New Project' 버튼을 눌러 프로젝트를 생성하세요.

2. API Key 및 App ID 발급

프로젝트 설정 페이지의 API & Auth 섹션에서 Secret Key 와 App ID를 확인할 수 있습니다. 이 키는 API 요청 시 인증을 위해 사용되므로 외부에 노출되지 않도록 주의하세요.

3. 첫 API 호출

이제 준비가 끝났습니다. 아래 cURL 예제를 사용하여 Moai Lingua 모듈에서 'Hello'라는 단어의 30개 언어 번역 데이터를 호출해보세요.

curl --request GET \
  --url 'https://api.moai.page/v1/lingua/translate?word=hello' \
  --header 'Authorization: Bearer YOUR_SECRET_KEY' \
  --header 'X-App-ID: YOUR_APP_ID'

응답 예시

정상적으로 요청이 완료되면 다음과 같은 JSON 응답을 받게 됩니다.

{
  "status": "success",
  "data": {
    "word": "hello",
    "translations": {
      "ko": "안녕",
      "ja": "こんにちは",
      "en": "Hello",
      "fr": "Bonjour",
      "...": "..."
    }
  }
}

다음 단계

기본적인 호출에 성공했다면, 이제 각 모듈별 상세 가이드를 통해 더 복잡한 기능을 구현해볼 수 있습니다.