GlocalPost API로 연동하세요

RESTful API로 캠페인 생성·수신자 관리·발송 추적을 자사 시스템에 직접 통합할 수 있습니다.

전체 API 레퍼런스 (Swagger)API 키 발급하기 →

Quick Start

포털 설정 > API 키 에서 키를 발급한 후, Authorization 헤더에 Bearer 토큰으로 사용하세요.

Base URL

https://api.glocalpost.com/api/v1

인증 (Authentication)

모든 API 요청에 발급된 API 키를 Bearer 토큰으로 첨부합니다.

curl -X GET "https://api.glocalpost.com/api/v1/campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

플랜별 API 호출 한도

한도 초과 시 HTTP 429 Too Many Requests 를 반환합니다.

플랜	호출 한도	월간 발송 한도
Free	60 rpm	1,000 / mo
Starter	300 rpm	10,000 / mo
Pro	1,000 rpm	100,000 / mo
Enterprise	5,000 rpm	Unlimited

핵심 엔드포인트

메서드	엔드포인트	설명
GET	/campaigns	List campaigns
POST	/campaigns	Create campaign
POST	/campaigns/{id}/submit	Submit & pay campaign
GET	/recipients/lists	List recipient lists
POST	/recipients/lists	Create recipient list
POST	/recipients/lists/{id}/upload-csv	Upload CSV
GET	/tracking/shipments	List shipments
GET	/tracking/shipments/{id}	Shipment detail & events
GET	/countries	Active destination countries

전체 API 레퍼런스 (Swagger) →

Webhook 이벤트

캠페인·발송 상태 변경 시 등록한 URL로 POST 요청을 전송합니다. 포털 설정에서 Webhook URL을 등록하세요.

// POST YOUR_WEBHOOK_URL
{
  "event": "shipment.delivered",
  "timestamp": "2026-05-07T10:30:00Z",
  "data": {
    "shipmentId": "550e8400-...",
    "recipientId": "...",
    "deliveredAt": "2026-05-07T10:28:00Z"
  }
}

이벤트	페이로드 주요 필드
campaign.submitted	campaignId, totalCount, totalBilling, currency
campaign.completed	campaignId, completedAt
campaign.cancelled	campaignId, reason, cancelledAt
shipment.dispatched	shipmentId, recipientId, trackingNumber
shipment.delivered	shipmentId, deliveredAt
shipment.returned	shipmentId, reason, returnedAt
translation.ready	campaignId, targetLang, translatedText

GlocalPost API로 연동하세요

포털 설정 > API 키 에서 키를 발급한 후, Authorization 헤더에 Bearer 토큰으로 사용하세요.

API 키 발급하기 → 전체 API 레퍼런스 (Swagger) →