Skip to content

List Rewards

브이리뷰 리뷰 업로드로 발생하는 적립금에 대한 정보를 start_date(시작일)~end_date(종료일)로 확인합니다.

모든 API 는 유효한 Authorization 헤더가 있어야 사용할 수 있습니다. 헤더를 작성하는 방법은 토큰 생성과 검증 문서를 참고하시기 바랍니다.

API 정보

[GET] /api/v1/rewards/

요청

?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD
항목 설명 필수
start_date YYYY-MM-DD 포맷의 날을 입력해주시면 됩니다. 입력한 날부터 해당하는 적립 내역을 조회합니다. 필수
end_date YYYY-MM-DD 포맷의 날을 입력해주시면 됩니다. 입력한 날까지 해당하는 적립 내역을 조회합니다. start_dateend_date 는 같을 수 있습니다. 필수

요청 예시

curl --location --request GET 'https://URL/api/v1/products/?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic <TOKEN>' \
import requests
import json

url = "https://URL/api/v1/products/?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD"

payload={}
headers = {
  'Accept': 'application/json',
  'Content-Type': 'application/json',
  'Authorization': 'Basic <TOKEN>'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
import java.io.*;
import okhttp3.*;
public class main {
  public static void main(String []args) throws IOException{
    OkHttpClient client = new OkHttpClient().newBuilder()
      .build();
    Request request = new Request.Builder()
      .url("https://URL/api/v1/products/?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD")
      .method("GET", null)
      .addHeader("Accept", "application/json")
      .addHeader("Content-Type", "application/json")
      .addHeader("Authorization", "Basic <TOKEN>")
      .build();
    Response response = client.newCall(request).execute();
    System.out.println(response.body().string());
  }
}
import com.mashape.unirest.http.*;
import java.io.*;
public class main {
  public static void main(String []args) throws Exception{
    Unirest.setTimeouts(0, 0);
    HttpResponse<String> response = Unirest.get("https://URL/api/v1/products/?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD")
      .header("Accept", "application/json")
      .header("Content-Type", "application/json")
      .header("Authorization", "Basic <TOKEN>")
      .asString();

    System.out.println(response.getBody());
  }
}
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://URL/api/v1/products/?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Accept", "application/json")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Basic <TOKEN>")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://URL/api/v1/products/?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Accept: application/json',
    'Content-Type: application/json',
    'Authorization: Basic <TOKEN>'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://URL/api/v1/products/?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD',
  headers: { 
    'Accept': 'application/json', 
    'Content-Type': 'application/json', 
    'Authorization': 'Basic <TOKEN>'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

✅ 응답 - 200

{
  "results": [
    {
      "created_at": "2021-08-30T08:30:27.962Z",
      "member_id": "string",
      "rewards": 0,
      "reason": "string"
    }
  ]
}

❌ 응답 - 400

{
  "detail": "<에러의 내용>"
}
400 에러의 내용은 아래와 같습니다.

detail 설명
'start_date' is later than the 'end_date'. start_date 보다 end_date 보다 늦은 날짜로 입력되었습니다.

❌ 응답 - 401

{
  "detail": "<에러의 내용>"
}
401 에러의 내용은 아래와 같습니다.

detail 설명
Authorization header required. 인증 헤더가 설정되어있지 않은 경우입니다.
Authorization header was invalid. 인증 헤더가 올바르지 않은 형식으로 되어있는 경우입니다.
Access key id was invalid. 인증 헤더의 Access key id가 유효하지 않은 경우입니다.
Secret access key was invalid. 인증 헤더의 Secret access key가 유효하지 않은 경우입니다.

❌ 응답 - 422

요청 바디의 유효성 검증이 실패한 경우입니다.

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}