에이전트 블롭 올리기

PUT

/api/v1/relay/blobs/{request_id}/{name}

const url = 'https://dev.api.endueos.com/api/v1/relay/blobs/example/example';
const options = {method: 'PUT', headers: {'Content-Type': '*/*'}, body: 'example'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PUT \
  --url https://dev.api.endueos.com/api/v1/relay/blobs/example/example \
  --header 'Content-Type: */*' \
  --data example

에이전트가 명령의 큰 바이트(스크린샷·파일)를 올린다 — 와이어 프로토콜 v1.1. 인증은 연결 토큰(Authorization: Bearer osat_…)이다. request_id 는 이 에이전트의 진행 중인 명령이어야 한다 (아니면 409 BLOB_NOT_ALLOWED). 64 MiB 까지 (413 BLOB_TOO_LARGE). 같은 이름으로 다시 올리면 덮어쓴다. 24시간 보관한다.

가이드 — 내 에이전트 붙이기

인증

None

파라미터

경로 파라미터

request_id

필수

string

name

필수

string

^[a-z0-9][a-z0-9._-]{0,63}$

요청 본문^필수

*/*

응답

201

만들었다.

application/json

object

data

필수

에이전트가 HTTPS 로 올린 큰 바이트의 참조 (와이어 프로토콜 v1.1). 출력에서는 {이름}_blob 필드로 온다 (예: image_blob). 내려받기는 GET /commands/{command_id}/blobs/{name}.

object

name

필수

string

mime_type

필수

string

size

필수

integer format: int64

sha256

필수

본문의 SHA-256 (hex).

string

meta

필수

object

request_id

필수

string

timestamp

필수

string format: date-time

duration

서버 처리 시간(ms).

integer format: int32

예시^{자동 생성}

{
  "data": {
    "name": "example",
    "mime_type": "example",
    "size": 1,
    "sha256": "example"
  },
  "meta": {
    "request_id": "example",
    "timestamp": "2026-04-15T12:00:00Z",
    "duration": 1
  }
}

401

인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.

409

지금 상태와 충돌한다 — 코드는 위 설명을 본다. 본문은 오류 봉투.

413

본문이 상한을 넘었다. 본문은 오류 봉투.

503

의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.

에이전트 블롭 올리기

인증

파라미터

경로 파라미터

요청 본문필수

응답

201

예시자동 생성

401

409

413

503

요청 본문^필수

예시^{자동 생성}