콘텐츠로 이동

구성

실험 시작 전, 파이펫과 덱 레이아웃을 지정합니다. 런타임 메모리에 즉시 반영됩니다.

요청 본문의 값은 먼저 라이브러리에서 확인하세요

파이펫 타입 · 랩웨어 · 모듈 이름은 임의로 적는 값이 아니라, 아래 조회 API가 반환하는 key 값을 그대로 요청 본문에 넣어야 합니다.

조회 대상 엔드포인트
파이펫 타입 GET /api/v1/resource/library/pipette
랩웨어 이름 GET /api/v1/resource/library/labware
모듈 이름 GET /api/v1/resource/library/module

라이브러리 응답은 카테고리 → 이름 → 상세 구조로 중첩되어 있습니다. 예를 들어 랩웨어 조회 응답은 다음과 같습니다.

GET /api/v1/resource/library/labware 응답 (발췌)
{
  "success": true,
  "status_code": 200,
  "data": {
    "trash": {
      "ablelabs_trash": {
        "product_name": "Trash",
        "well_count": 96
      }
    },
    "tip_box": {
      "ablelabs_tip_box_200": {
        "product_name": "Tip Box 200uL",
        "well_count": 96
      }
    }
  }
}

요청 본문에는 카테고리명(trash, tip_box)이 아니라 그 안의 이름 key(ablelabs_trash, ablelabs_tip_box_200)를 사용합니다. 파이펫과 모듈도 동일하게 응답의 이름 key를 사용합니다.

파이펫 구성

POST /api/v1/config/pipette

1~2번 파이펫에 타입을 할당합니다.

사용 가능한 타입: 1ch_20ul, 1ch_200ul, 1ch_1000ul, 8ch_20ul, 8ch_200ul, 8ch_1000ul

요청 본문
{ "1": "8ch_200ul", "2": "1ch_1000ul" }

GET /api/v1/config/pipette

현재 할당된 파이펫 구성을 반환합니다. 미할당 슬롯은 null.

응답 data
{ "1": "8ch_200ul", "2": null }

덱 구성

POST /api/v1/config/deck

1~12번 덱 위치에 랩웨어를 배치합니다.

각 위치 값은 두 형태를 가질 수 있습니다.

  • 문자열 — labware만: "spl_96_well_plate_30096"
  • 객체 — module/labware 조합: {"module": "odtc", "labware": "..."}
요청 본문
{
  "9": "ablelabs_tip_box_200",
  "1": "spl_96_well_plate_30096",
  "12": "ablelabs_trash"
}

ODTC(열 순환기) 등 모듈 위에 플레이트를 배치할 때는 객체 형태를 사용합니다.

요청 본문
{
  "9": "ablelabs_tip_box_200",
  "1": "spl_96_well_plate_30096",
  "11": { "module": "odtc", "labware": "spl_96_well_plate_30096" },
  "12": "ablelabs_trash"
}

조회 시 반환 형태

GET /api/v1/config/deck 응답의 각 위치는 — labware만이면 문자열, module이 있으면 객체, 비어 있으면 null 로 반환됩니다.