그룹전송(JSON)

json 으로 생성된 여러사용자에게 전송

그룹전송

POST https://push.mint-app.com/v1/push/group/json

여러사람에게 푸쉬를 전송하기 위한 api 입니다 header에 인증 정보를 꼭 넣어주세요.

Request Body

Name	Type	Description
reserved_date	string	예약 시간(yyyy-MM-dd hh:mm:ss) 형식
title	string	푸쉬의 간단한 제목(실제로 전송되지는 않음)
message	array	push json array

200 성공적으로 푸쉬를 보냈을때 data.success : 성공적으로 전송한 디바이스 갯수 data.failed: 푸쉬 전송이 실패한 갯수(앱삭제,기기 포맷등 다양한 이유로 실패할수 있다.)

{
    "result": "success",
    "data": {
        "send_count": 2
    }
}

400

{
    "result": "failed",
    "reason": "잘못된 JSON 형식입니다."
}

401 인증정보가 잘못 되었을때

{
    "result": "failed",
    "reason": "유효하지 않은 키값입니다."
}

404 Could not find a cake matching this query.

{
    "result": "failed",
    "reason": "존재하지 않는 사용자입니다."
}

message 형식

[
  {
    "user_id":"user_id",
    "title":"title",
    "body":"body",
    "badge":1,
    "image_url":"https://img.domain.com/image.jpg",
    "url":"https://domain.com/index.php"
  }
]

• 세부 파라미터는 개인송과 동일하지만 image_file은 사용할수 없다. image_url을 생성해서 전송해야된다.

• 사용자 아이디는 중복해서 사용할수 없다.

sample

curl

curl --location --request POST 'https://push.mint-app.com/v1/push/group/json' \
--header 'Accept: application/json' \
--header 'api-key: {api-key}' \
--header 'api-secret: {api-sercret}' \
--form 'title="test 메시지"' \
--form 'reserved_date="2021-09-01 12:00:00"' \
--form '=@"/path/to/file"' \
--form 'message="[
  {
    \"user_id\":\"1\",
    \"title\":\"title\",
    \"body\":\"body\",
    \"badge\":1,
    \"image_url\":\"https://img.domain.com/image.jpg\",
    \"url\":\"https://domain.com/index.php\"
  }
]"'

php(curl)

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://push.mint-app.com/v1/push/group/json',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('title' => 'test 메시지','reserved_date' => '2021-09-01 12:00:00',''=> new CURLFILE('/path/to/file'),'message' => '[
  {
    "user_id":"1",
    "title":"title",
    "body":"body",
    "badge":1,
    "image_url":"https://img.domain.com/image.jpg",
    "url":"https://domain.com/index.php"
  }
]'),
  CURLOPT_HTTPHEADER => array(
    'Accept: application/json',
    'api-key: {api-key}',
    'api-secret: {api-sercret}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

java(okhttp)

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("title","test 메시지")
  .addFormDataPart("reserved_date","2021-09-01 12:00:00")
  .addFormDataPart("","file",
    RequestBody.create(MediaType.parse("application/octet-stream"),
    new File("/path/to/file")))
  .addFormDataPart("message","[
  {
    \"user_id\":\"1\",
    \"title\":\"title\",
    \"body\":\"body\",
    \"badge\":1,
    \"image_url\":\"https://img.domain.com/image.jpg\",
    \"url\":\"https://domain.com/index.php\"
  }
]")
  .build();
Request request = new Request.Builder()
  .url("https://push.mint-app.com/v1/push/group/json")
  .method("POST", body)
  .addHeader("Accept", "application/json")
  .addHeader("api-key", "{api-key}")
  .addHeader("api-secret", "{api-secret}")
  .build();
Response response = client.newCall(request).execute();