스페이스

참고
전문가 수준
API 키는 요청의 권한 부여 헤더에 베어러 토큰으로 전송되어야 합니다. API 키 받기.
목록

API 엔드포인트:

GET
https://goo.vc/api/v1/spaces?ko

요청 예시:

curl --location --request GET 'https://goo.vc/api/v1/spaces?ko' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
매개변수
유형
설명
search
선택 사항 string
검색 쿼리입니다.
search_by
선택 사항 string
검색 기준. 가능한 값은 다음과 같습니다: 이름의 경우 name. 기본값은 name.
sort_by
선택 사항 string
정렬 기준. 가능한 값은 다음과 같습니다: 생성 날짜의 경우 id, 이름의 경우 name. 기본값은 id.
sort
선택 사항 string
정렬. 가능한 값은 다음과 같습니다: 내림차순의 경우 desc, 오름차순의 경우 asc. 기본값은 desc.
per_page
선택 사항 integer
페이지당 결과. 가능한 값은 다음과 같습니다: 10, 25, 50, 100. 기본값은 10.
표시

API 엔드포인트:

GET
https://goo.vc/api/v1/spaces/{id}?ko

요청 예시:

curl --location --request GET 'https://goo.vc/api/v1/spaces/{id}?ko' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
스토어

API 엔드포인트:

POST
https://goo.vc/api/v1/spaces?ko

요청 예시:

curl --location --request POST 'https://goo.vc/api/v1/spaces?ko' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'name={name}'
매개변수
유형
설명
name
필수 string
스페이스 이름입니다.
color
선택 사항 integer
색상 코드입니다. 가능한 값은 다음과 같습니다: 1, 2, 3, 4, 5, 6. 기본값은 1.
업데이트

API 엔드포인트:

PUT PATCH
https://goo.vc/api/v1/spaces/{id}?ko

요청 예시:

curl --location --request PUT 'https://goo.vc/api/v1/spaces/{id}?ko' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}'
매개변수
유형
설명
name
선택 사항 string
스페이스 이름입니다.
color
선택 사항 integer
색상 코드입니다. 가능한 값은 다음과 같습니다: 1, 2, 3, 4, 5, 6.
삭제

API 엔드포인트:

DELETE
https://goo.vc/api/v1/spaces/{id}?ko

요청 예시:

curl --location --request DELETE 'https://goo.vc/api/v1/spaces/{id}?ko' \
--header 'Authorization: Bearer {api_key}'