조회

메시지키를 기준으로 리포트를 조회합니다.

• 리포트 연동방식(Polling / Webhook)으로 전달되지 못한 개별 리포트 들을 조회하기 위한 API 입니다.

최대 30일 이전의 리포트를 조회 할 수 있습니다.

리포트 개별 조회

GET /v1/report/inquiry/{msgKey}

Request

Header

Name	Type	Description
Authorization	String	schema + “ “ + token
Accept	String	application/json

Path Parameter

Name	Type	Required	Description
msgKey	String	YES	메시지 키

cURL

curl -X GET https://omni.ibapi.kr/v1/report/inquiry/메시지키\
-H "content-type: application/json" \
-H "Accept: application/json" \
-H "Authorization:Bearer 발급받은 토큰" 

JAVA

import java.io.*;
import okhttp3.*;
public class Main {
  public static void main(String []args) throws IOException{
    OkHttpClient client = new OkHttpClient().newBuilder()
      .build();
    MediaType mediaType = MediaType.parse("application/json");
    RequestBody body = RequestBody.create(mediaType, "");
    Request request = new Request.Builder()
      .url("https://omni.ibapi.kr/v1/report/inquiry/msgKey")
      .method("GET", body)
      .addHeader("Content-Type", "application/json")
      .addHeader("Accept", "application/json")
      .addHeader("Authorization", "Bearer 발급받은 토큰")
      .build();
    Response response = client.newCall(request).execute();
    System.out.println(response.body().string());
  }
}

Go

package main

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

func main() {

  url := "https://omni.ibapi.kr/v1/report/inquiry/msgKey"
  method := "GET"

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

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Accept", "application/json")
  req.Header.Add("Authorization", "Bearer 발급받은 토큰")

  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

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://omni.ibapi.kr/v1/report/inquiry/msgKey',
  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(
    'Content-Type: application/json',
    'Accept: application/json',
    'Authorization: Bearer 발급받은 토큰'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

NodeJS

var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://omni.ibapi.kr/v1/report/inquiry/msgKey',
  'headers': {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'Authorization': 'Bearer 발급받은 토큰'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

C#

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://omni.ibapi.kr/v1/report/inquiry/msgKey");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer 발급받은 토큰");
var content = new StringContent(string.Empty);
content.Headers.ContentType = new MediaTypeHeaderValue("application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

JavaScript

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Accept", "application/json");
myHeaders.append("Authorization", "Bearer 발급받은 토큰");

var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://omni.ibapi.kr/v1/report/inquiry/msgKey", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

python

import http.client
import json

conn = http.client.HTTPSConnection("omni.ibapi.kr")
payload = ''
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer 발급받은 토큰'
}
conn.request("GET", "/v1/report/inquiry/msgKey", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Ruby

require "uri"
require "json"
require "net/http"

url = URI("https://omni.ibapi.kr/v1/report/inquiry/msgKey")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Content-Type"] = "application/json"
request["Accept"] = "application/json"
request["Authorization"] = "Bearer 발급받은 토큰"

response = https.request(request)
puts response.read_body

Response

Header

Name	Type	Description
Content-Type	String	application/json

Body

Name	Type	Description
code	String(4)	API호출 결과 코드
result	String	API호출 결과 설명
data	Object	API호출 데이터

Schema

data

Name	Type	Description
report	Object Array Name Type Description msgKey String 메시지 키 serviceType String 서비스 타입 msgType String 메시지 타입 sendTime String 전송 처리 일시(ISO 8601, yyyy-MM-dd'T'HH:mm:ssXXX) reportTime String 리포트 일시(ISO 8601, yyyy-MM-dd'T'HH:mm:ssXXX) reportType String 리포트 종류 reportCode String 리포트 코드 reportText String 리포트 상세 carrier String 이통사 코드 userType String 메시지 발송 처리 타입 브랜드메시지 기본형 발송만 해당 F: (메시지 발송 시점) 채널 친구 사용자에게 발송되는 타입 N: (메시지 발송 시점) 채널 친구가 아닌 사용자에게 발송되는 타입 resCnt String 국제메시지 분할 수 ref String 참조 필드	리포트 정보

HTTP 200(성공:Success)

{
    "code": "A000",
    "result": "Success",    
    "data": {         
         "report":[
             {
               "msgKey": "메시지 키",
               "serviceType": "서비스 타입",
               "msgType": "메시지 타입",
               "sendTime": "2024-00-00T00:00:00+09:00",
               "reportTime": "2024-00-00T00:00:00+09:00",
               "reportType": "0",
               "reportCode": "10000",
               "reportText": "Success",
               "userType":"F",
               "carrier": "10001",
               "ref": "요청시 입력한 데이터"
             }
         ]
    }     
}

HTTP 400(실패:Bad Requests)

{
    "code": "A801",
    "result": "Invalid Message ID"
} 

HTTP 401(실패:Unauthorized)

{
    "code": "A001",
    "result": "Expired token"
}

HTTP 429(실패:Too Many Requests)

{
    "code": "A020",
    "result": "Rate limit exceeded"
}

HTTP 500(실패:Forbidden)

{
    "code": "A999",
    "result": "Unknown error"
}