Codes API

코드(Code)는 데이터 처리를 위한 Python 스크립트나 SQL 쿼리를 관리하는 자산입니다.

1. List Codes

Request

GET /codes/

2. Create Code (Metadata)

코드 자산의 메타데이터를 생성합니다. (실제 파일 내용은 별도 API로 업로드)

Request

POST /codes/

Body Schema (Code)

Field	Type	Required	Description
name	string	Yes	코드 자산 이름
type	string	No	코드 유형 (python, sql 등)
options	object	No	실행 옵션 또는 환경 설정

Example

{
  "name": "etl_script_v1",
  "type": "python",
  "tags": ["etl", "daily"]
}

3. Upload Code File

코드 자산의 실제 스크립트 내용을 업로드합니다.

Request

PUT /codes/{code_id}/file

• Content-Type: application/octet-stream (또는 text/plain)
• Body: 스크립트 텍스트 전체

Example

import pandas as pd

def process(df):
    df['processed'] = True
    return df

4. Get Code File

저장된 코드 스크립트 내용을 다운로드합니다.

Request

GET /codes/{code_id}/file

Response

• Content-Type: application/octet-stream
• Body: 스크립트 텍스트

5. Get Code File Versions

코드 파일의 변경 이력(버전)을 조회합니다.

Request

GET /codes/{code_id}/file/versions

Response

[
  {
    "version": "v1",
    "is_latest": false,
    "last_modified": 1704000000000
  },
  {
    "version": "v2",
    "is_latest": true,
    "last_modified": 1704090000000
  }
]