Main Site

API 문서

MetaCivia API는 RESTful API를 제공합니다.

Base URL

https://metacivia-backend.pages.dev

인증

지갑 기반 인증

대부분의 API는 지갑 주소를 헤더로 전송해야 합니다:

X-Wallet-Address: 0x1234...

API Key 인증 (외부 API)

외부 시스템에서 API를 사용하려면 API Key가 필요합니다:

X-API-Key: your-api-key-here

Rate Limiting

  • 기본 제한: 100 requests/minute per API key or IP
  • 초과 시: 429 Too Many Requests 응답

주요 API 엔드포인트

Citizen API

  • GET /api/citizen/status - 시민 상태 조회
  • POST /api/citizen/mint - 시민 민팅
  • GET /api/citizen/chronicle - Chronicle 조회
  • GET /api/citizen/credit - Credit 조회
  • GET /api/citizen/rank - Rank 조회

Chronicle API

  • GET /api/chronicle/nation - 국가 Chronicle
  • POST /api/chronicle/anchor - Anchor 생성
  • GET /api/chronicle/anchor/:era - Anchor 조회

Credit API

  • POST /api/citizen/action - 행동 기록
  • GET /api/citizen/credit - Credit 상태

Rank API

  • GET /api/citizen/rank - Rank 정보
  • POST /api/citizen/rank/check - 승급 체크

Architect API

  • GET /api/architect/verify - Architect 확인
  • GET /api/architect/status - 문명 상태
  • GET /api/architect/karma - Karma 조회

City-State API

  • POST /api/citystate - City-State 생성
  • GET /api/citystate - 목록 조회
  • POST /api/citystate/:id/join - 가입

에러 응답

모든 에러는 다음 형식으로 반환됩니다:

{
  "error": "Error message"
}

HTTP 상태 코드

  • 200: 성공
  • 400: Bad Request
  • 401: Unauthorized
  • 403: Forbidden
  • 404: Not Found
  • 409: Conflict
  • 429: Too Many Requests
  • 500: Internal Server Error

다음 단계