콘텐츠로 이동
adaptmailAPI
한국어

사서함 설정

API 0.16.0OpenAPIllms-full.txt
PATCH/v1/mailboxes/{mailbox_id}

/v1에서 name, password, signature를 변경할 수 있습니다. 공용 quota_mb는 호스팅 패널에서 변경합니다. 파일에는 별도 한도가 없습니다. Idempotency-Key는 선택 사항이지만 재시도 시 사용하는 것이 좋습니다.

승인 및 접근 영역 · 오류와 반복

요구

터미널 창
curl -X PATCH 'https://adapt-mail.com/v1/mailboxes/<mailbox_id>' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Idempotency-Key: message-20261019-0001' \
  -H 'Content-Type: application/json' \
  --data '{"name":"Support","signature":"Support team"}'

옵션

mailbox_idpath반드시

integer

X-Customer-IDheader
옵션 1

string

옵션 2

null

Idempotency-Keyheader

string

minLength: 8

maxLength: 128

요청 본문 · application/json

object

name
옵션 1

string

minLength: 1

maxLength: 120

옵션 2

null

quota_mb
옵션 1

integer

minimum: 10240

옵션 2

null

file_quota_mb
옵션 1

integer

minimum: 256

maximum: 512000

옵션 2

null

password
옵션 1

string

minLength: 12

maxLength: 128

옵션 2

null

signature
옵션 1

string

maxLength: 5000

옵션 2

null

알 수 없는 필드는 허용되지 않습니다.

응답

202 성공적인 응답

application/json

object

id

string · uuid

상태를 확인하고 보류 중인 제출을 취소하기 위한 작업 ID입니다.

kind

string

mailbox_id
옵션 1

integer

옵션 2

null

status

string

유효한 값: "queued" "running" "succeeded" "failed" "uncertain" "cancelled"

run_at

string

UTC.의 날짜 및 시간 오프셋이 없으면 값은 UTC.도 나타냅니다.

created_at

string

UTC.의 날짜 및 시간 오프셋이 없으면 값은 UTC.도 나타냅니다.

completed_at
옵션 1

string

UTC.의 날짜 및 시간 오프셋이 없으면 값은 UTC.도 나타냅니다.

옵션 2

null

error

작업이 성공적으로 완료되지 않은 경우 오류가 발생하는 이유입니다.

옵션 1

string

옵션 2

null

result

작업 결과입니다. 전송의 경우 수락 및 거부된 수신자에 대한 정보가 포함됩니다.

옵션 1

object

옵션 2

null

400 잘못된 헤더 또는 식별자

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

401 로그인이 필요합니다

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

403 접근 불가

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

404 리소스를 찾을 수 없습니다.

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

409 국가 갈등

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

422 유효성 검사 오류

application/json

object

detail

array

배열 요소

object

loc반드시

array

배열 요소
옵션 1

string

옵션 2

integer

msg반드시

string

type반드시

string

503 일시적인 이용 불가

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object