서브포켓 자산 이전 가능 범위

본 API는 서브포켓의 API Key 권한을 사용하여 해당 서브포켓의 자산을 다른 포켓으로 이전하는 API입니다. 서브포켓의 API Key를 사용하여 다음과 같은 자산 이전을 요청할 수 있습니다.

• 서브포켓 → 메인포켓 : to를 지정하지 않으면 기본적으로 메인포켓으로 이전됩니다.
• 서브포켓 → 서브포켓 : to로 지정한 다른 서브포켓 UUID으로 자산을 이전합니다.

flowchart LR

    A[서브포켓] -->|to 미지정| B[메인포켓]
    A -->|to 지정| C[다른 서브포켓]

조회하고자하는 포켓 UUID는 포켓 정보 조회 API를 통해 확인할 수 있습니다.

서브포켓 자산 이전 흐름 예시

flowchart LR
    A[포켓 정보 조회<br/>GET /v1/pockets]
    --> B[포켓 UUID 확인]

    B --> C[자산 이전 요청]

    C --> D{to 지정 여부}

    D -->|미지정| E[메인포켓으로 이전]
    D -->|지정| F[지정한 포켓으로 이전]

    E --> G[이전 요청 처리]
    F --> G

    G --> H[submitted]
    H --> I[processing]
    I --> J[done 또는 failed]

유의사항

• 동일한 포켓 간 자산 이전은 지원하지 않습니다. (from != to)
• 자산 이전 요청에는 고유한 identifier를 사용할 수 있습니다.
• identifier는 이전 성공 여부와 관계없이 한 번만 사용할 수 있으며, 이미 사용된 값은 재사용할 수 없습니다.
• identifier 지정 시 허용규격은 1~64자 내의 문자, 숫자, 언더스코어(_), 점(.), 하이픈(-) 입니다.
• to에 지정하는 포켓 UUID는 포켓 정보 조회 API(GET /v1/pockets)를 통해 확인할 수 있습니다.

상태(State)

자산 이전 요청은 다음 상태 중 하나를 가집니다.