멤버 목록

curl --request GET \
  --url https://openapi.pluuug.com/v1/member \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Signature: <api-key>'

{
  "results": [
    {
      "id": 123,
      "nickname": "<string>",
      "email": "<string>",
      "isActive": true,
      "grade": {
        "id": 123,
        "title": "<string>"
      }
    }
  ],
  "next": "http://api.example.org/accounts/?cursor=cD00ODY%3D\"",
  "previous": "http://api.example.org/accounts/?cursor=cj0xJnA9NDg3"
}

멤버

멤버 목록 조회

비즈니스의 멤버(Member) 목록을 최신순(created DESC)으로 조회합니다. 각 멤버는 사용자 정보(user)와 등급(grade)을 nested로 포함합니다.

플랜 제약: FREE/TEAM/AGENCY 플랜에서만 사용 가능 — 다른 플랜은 403 PLAN_PERMISSION_DENIED.

검색: search 쿼리 파라미터는 복수 전달 시 AND 결합으로 동작합니다 (예: ?search=A&search=B는 닉네임/이메일 중 A·B 모두 포함하는 멤버만 반환).

용도: 의뢰 담당자(in_charge_set) 지정 시 Member.id로 참조됩니다.

GET

member

멤버 목록

curl --request GET \
  --url https://openapi.pluuug.com/v1/member \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Signature: <api-key>'

{
  "results": [
    {
      "id": 123,
      "nickname": "<string>",
      "email": "<string>",
      "isActive": true,
      "grade": {
        "id": 123,
        "title": "<string>"
      }
    }
  ],
  "next": "http://api.example.org/accounts/?cursor=cD00ODY%3D\"",
  "previous": "http://api.example.org/accounts/?cursor=cj0xJnA9NDg3"
}

Authorizations

X-API-Key

string

header

required

X-Signature

string

header

required

HMAC-SHA256 방식으로 body를 secret key로 해싱하여 생성한 서명을 넣어야 합니다. 서버는 X-API-Key와 대응되는 secret key로 서명을 검증합니다.

Query Parameters

cursor

string

Pagination을 위한 커서

is_active

boolean

page_size

integer

한번에 조회할 데이터의 개수 (limit)

string[]

검색어 (복수 전달 시 AND 결합). 닉네임/이메일에 대해 부분 일치(icontains).

Response

200 - application/json

results

object[]

required

Show child attributes

string<uri> | null

Example:

"http://api.example.org/accounts/?cursor=cD00ODY%3D\""

string<uri> | null

Example:

"http://api.example.org/accounts/?cursor=cj0xJnA9NDg3"

실무자 삭제 필드 목록 조회