요청과 응답

Base URL

모든 엔드포인트는 다음 주소 아래에 있습니다.

https://api.youvico.com/api

헤더

헤더	값
Authorization	Bearer YOUR_API_KEY
Content-Type	application/json. 본문이 있는 요청에 사용

요청 본문

API는 JSON으로 요청을 받고 응답합니다.

• 페이지네이션을 쓰는 목록 엔드포인트는 QUERY 메서드를 쓰고 입력값을 본문으로 받습니다. 입력값이 없으면 {}를 보내야 합니다.
• 다른 리소스를 가리킬 때는 id를 담은 객체를 보내야 합니다.

{
  "folder": { "id": "DX1234567890ABCD" }
}

응답 본문

결과가 있는 응답은 결과를 data에 담습니다.

{
  "data": {
    "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62",
    "name": "Launch Campaign"
  }
}

• 페이지로 나뉘는 목록은 page 객체도 함께 반환합니다. 페이지네이션을 참고합니다.
• 수정, 삭제처럼 반환할 결과가 없는 요청은 204 No Content로 응답합니다.
• 실패한 요청은 error 객체를 반환합니다. 에러를 참고합니다.

시각

시각은 YYYY-MM-DD HH:mm:ss[.ffffff] 형식의 UTC 문자열입니다. 예: 2026-04-10 05:11:44.482913

필드 타입

API 레퍼런스의 필드 목록은 다음 표기를 사용합니다.

표기	의미
string	항상 해당 타입의 값
string?	해당 타입의 값 또는 null

required가 표시된 요청 필드는 반드시 보내야 하며, 나머지 요청 필드는 생략할 수 있습니다.