HTTP

HTTP 통신 기반의 API 서버운영이기 때문에 HTTP에 대한 설명을 기재합니다.

HTTP Method & CDN Action

HTTP	CDN Action	Description
GET	조회	CDN 리소스 및 상태를 조회합니다.
POST	생성/작업	CDN 리소스를 생성합니다. C/R/U/D외의 작업을 수행합니다.
PUT	변경	CDN 리소스의 내용을 수정합니다. 포함되지 않은 Attribute는 기존의 것을 그대로 사용합니다. 특정 Attribute를 삭제하고자 할 경우에는 빈 값을 요청합니다.
DELETE	삭제	CDN 오브젝트를 삭제합니다.

해당 API는 현재 GET과 POST 메서드만 지원합니다.

그 외의 메서드는 허용하지 않으므로, "405 Method Not Aollowed" 응답 코드를 반환합니다.

HTTP Request

Header

HTTP Header	Description
Content-Type	HTTP Body 컨텐츠의 타입입니다. 예) application/json (RFC 7159) 참조
Content-Length	HTTP Body 컨텐츠의 길이입니다.

Body

• Request Body 형식은 JSON만을 지원합니다. 자세한 내용은 각각의 API 설명과 예제를 참고합니다

HTTP Response

Header

HTTP Header	Description
Content-Type	HTTP Body 컨텐츠의 타입입니다. 예) application/json (RFC 7159) 참조
Content-Length	HTTP Body 컨텐츠의 길이입니다.

Body

• Response Body 형식은 JSON만을 지원합니다. Hash 또는 Array가 올 수 있습니다.

• 성공일 경우 응답이 있으면 아래와 같은 구조를 가집니다. 자세한 내용은 각각의 API 설명과 예제를 참고합니다.

Example

{
	"data": [
		{
			key1:value1,
			key2:value2,
			...
		},
		{
			key1:value1,
			key2:value2,
			...
		},
	],
}

Key	Value	Type	Description
data	-	Array	Object 별 데이터

Response code

• 응답 코드와 메시지를 정의합니다. 자세한 내용은 각각의 API 설명과 예제를 참고합니다.

Code	Message	Description
200	OK	성공
400	Bad Request	정의되지 않은 REST API 요청
404	Not Found	존재하지 않는 어플리케이션이나 스트림
405	Method Not Allowed	허용하지 않는 메서드
500	Internal Server Error	서버 에러

• 현재 솔박스 스트리밍 서버 API는 HTTP 1.1 을 지원합니다.

• URI : ASCII Character Set 만을 지원합니다.

• URI 외의 Character Set 은 UTF-8 을 기본으로 합니다.

• 메이저 버전이 증가한 경우 호환성을 위해 6개월간 기존 API를 유지한 뒤, 폐기합니다.