Search
moon
sun

API

1. ์ฐธ๊ณ  ์‚ฌํ•ญ

2. Version History

Search
์ƒ์„ฑ ์ผ์ž
ํƒœ๊ทธ
๋‹ด๋‹น์ž

3. API ์—ฐ๋™

1) ์บ ํŽ˜์ธ ๋ฆฌ์ŠคํŠธ

โ˜‘ https://api.greenp.kr/ads_json.html
1-1) Content Type
content-type=text/html;charset=UTF-8
1-2) Response Format
Output : JSON
{โ€˜rstโ€™: ...}
1-3) Request Parameter Information
HTTP Method : - POST, GET
Search
Param
Type
Size
Desc
string
20
๋ฐœ๊ธ‰๋œ ๋งค์ฒด์ฝ”๋“œ
int
ํŽ˜์ด์ง€์ˆ˜
int
ํŽ˜์ด์ง€๋‹น ๋ฆฌ์ŠคํŠธ์ˆ˜(default: 500)
1-4) Response Data
Search
Param
Type
Desc
string
์บ ํŽ˜์ธํ‚ค
string
์บ ํŽ˜์ธ๋ช…
string
ํŒจํ‚ค์ง€๋ช…
string
์บ ํŽ˜์ธ ์žฌ ์ฐธ์—ฌ ๊ฐ€๋Šฅ ์—ฌ๋ถ€ (Y: ์žฌ ์ฐธ์—ฌ ๊ฐ€๋Šฅ, N: ์žฌ ์ฐธ์—ฌ ๋ถˆ๊ฐ€)
string
์บ ํŽ˜์ธ ์•„์ด์ฝ˜ (์ธ๋„ค์ผ) ์ด๋ฏธ์ง€
string
์บ ํŽ˜์ธ ํ”ผ๋“œํ˜• ์ด๋ฏธ์ง€ (720x360)
string
์บ ํŽ˜์ธ ์ฐธ์—ฌ ์กฐ๊ฑด
string
์บ ํŽ˜์ธ์„ค๋ช…
int
๋ฆฌ์›Œ๋“œ๊ธˆ์•ก
string
OS๊ตฌ๋ถ„(A: AOS, I: IOS , W: WEB, ALL: ๋ชจ๋‘)
int
๊ด‘๊ณ ํ˜•์‹(1: CPI, 2: CPE, 3: CPA, 4: CPS, 6: CPC, 7: CPSNS, 8: ๋‰ด์Šค ํ”ผ๋“œ ์ ๋ฆฝํ˜•)
string
๊ด‘๊ณ ์„œ๋ธŒํ˜•์‹ - 7๋ฒˆ CPSNS์—๋งŒ ํ•ด๋‹น (L: ์œ ํŠœ๋ธŒ ์ข‹์•„์š”, Y: ์œ ํŠœ๋ธŒ ๊ตฌ๋…, I: ์ธ์Šคํƒ€ ํŒ”๋กœ์šฐ,F: ํŽ˜์ด์Šค๋ถ ์ข‹์•„์š”, K: ์นด์นด์˜คํ”Œ๋Ÿฌ์Šค ์นœ๊ตฌ, N: ๋„ค์ด๋ฒ„์Šคํ† ์–ด ์ฐœ, P: ๋„ค์ด๋ฒ„์ƒํ’ˆ ์ฐœ, Q: ๋„ค์ด๋ฒ„ ํฌ์ŠคํŠธ ํŒ”๋กœ์šฐ, C: ๋„ค์ด๋ฒ„ ์ฑ„๋„ ๊ตฌ๋…, T: ํŠธ์œ„ํ„ฐ ํŒ”๋กœ์šฐ, D: ํ‹ฑํ†ก ํŒ”๋กœ์šฐ, E: ๋„ค์ด๋ฒ„ ํ”Œ๋ ˆ์ด์Šค ์ €์žฅ, M: ๋ฉœ๋ก  ์Œ์›๋“ฃ๊ธฐ, Z: ๊ธฐํƒ€)
string
ํด๋ฆญ URL (์บ ํŽ˜์ธ์ฐธ์—ฌ url )

2) ์บ ํŽ˜์ธ ์ฐธ์—ฌ

2-1) Content Type
content-type=text/html;charset=UTF-8
2-2) Response Format
Output : JSON
{โ€˜rstโ€™: ...}
2-3) Request Parameter Information
HTTP Method : - POST, GET
Search
Param
Type
Size
Desc
string
40
(๊ธฐ๋ณธํฌํ•จ) ๋ฐœ๊ธ‰๋œ ์บ ํŽ˜์ธ์ฝ”๋“œ
string
10
(๊ธฐ๋ณธํฌํ•จ) ๋ฐœ๊ธ‰๋œ ๋งค์ฒด์ฝ”๋“œ
string
40
๋งค์ฒด ํŒŒํŠธ๋„ˆ ๊ณ ์œ ์•„์ด๋””
string
40
๊ตฌ๊ธ€๊ด‘๊ณ  ์•„์ด๋”” (์•ˆ๋“œ๋กœ์ด๋“œ์ผ ๊ฒฝ์šฐ๋งŒ) AdvertisingIdClient.Info idInfo = null; idInfo = AdvertisingIdClient.getAdvertisingIdInfo(mContext); return idInfo.getId();
string
40
iOS ๊ณ ์œ  ์‹๋ณ„์ž(IOS์ผ ๊ฒฝ์šฐ๋งŒ)
string
20
๋””๋ฐ”์ด์Šค ์•„์ด๋”” TelephonyManager mngr = (TelephonyManager)mContext.getSystemService(Context.TELEPHONY_SERVICE); return mngr.getDeviceId();
string
100
๊ตฌ๊ธ€ ๊ณ„์ • SHA1๋กœ ์ธ์ฝ”๋”ฉ ํ•œ๊ฒƒ์„ ๋‹ค์ค‘์ผ ๊ฒฝ์šฐ , ๋กœ ์—ฐ๊ฒฐํ•˜์—ฌ ์ฃผ์„ธ์š” Account[] accounts = AccountManager.get(mContext).getAccounts();
string
40
์•ˆ๋“œ๋กœ์ด๋“œ ์•„์ด๋”” return Settings.Secure.getString(mContext.getContentResolver(), Settings.Secure.ANDROID_ID);
string
40
๋ธŒ๋žœ๋“œ return Build.BRAND;
string
40
๋ชจ๋ธ return Build.MODEL;
string
20
์‚ฌ์šฉ์ž IP
string
255
๋งค์ฒด์šฉ ์ถ”๊ฐ€์ •๋ณด (๋งค์ฒด uniq ํด๋ฆญ๊ฐ’๋“ฑ)
string
1
y : ๋ฐ”๋กœ ์ด๋™ , ๋ณ€์ˆ˜๊ฐ€ ์—†์„๊ฒฝ์šฐ ๊ธฐ์กด json ๋ฆฌํ„ดํ•จ
2-4) Response Data
Search
Param
Type
Desc
string
S : ์„ฑ๊ณต E1 : ์ฐธ์—ฌ ๋Œ€์ƒ ์•„๋‹˜ E2 : ์ž˜๋ชป๋œ ์ ‘๊ทผ E3 : ์ข…๋ฃŒ๋œ ์ด๋ฒคํŠธ E4 : ๊ธˆ์ผ ์ฐธ์—ฌ๊ฐ€ ๋งˆ๊ฐ E5 : ์ด๋ฏธ ์ฐธ์—ฌํ–ˆ๋˜ ์ด๋ฒคํŠธ E6 : ์‚ฌ์šฉ ์•ˆ ํ•จ E7 : ๊ด‘๊ณ  ์ ‘์†์— ์‹คํŒจ E8 : ์ œํœด์‚ฌ๋กœ๋ถ€ํ„ฐ ์‘๋‹ต์š”์ฒญ์ด ์ง€์—ฐ E9 : ์„ค์น˜ํ•œ ๋‚ด์—ญ์ด ์กด์žฌ E10 : ์ง„ํ–‰ ์ค‘์ด์ง€ ์•Š์€ ๊ด‘๊ณ  E100 : ๊ธฐํƒ€ E101 : ์ƒํ’ˆ์ •๋ณด๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค. E103 : ํ•„์ˆ˜ ์ •๋ณด ๋ถ€์กฑ E104 : OS ํƒ€์ž…์ด ๋‹ค๋ฆ…๋‹ˆ๋‹ค. E105 : ์ œ์ถœํ•œ ๋ฏธ์…˜์ด ๊ฒ€ํ† ์ค‘์œผ๋กœ ์ ๋ฆฝ ๋Œ€๊ธฐ์ค‘์ž…๋‹ˆ๋‹ค.
string
์ฐธ์—ฌ ๋žœ๋”ฉ url
string
์—๋Ÿฌ๋ฉ”์„ธ์ง€

3) ํŒจํ‚ค์ง€ ์„ค์น˜ ์•Œ๋ฆผ (CPI ๊ฒฝ์šฐ)

3-1) Content Type
content-type=text/html;charset=UTF-8
3-2) Response Format
Output : JSON
{โ€˜rstโ€™: ...}
3-3) Request Parameter Information
HTTP Method : - POST, GET
Search
Param
Type
Size
Desc
string
40
๋ฐœ๊ธ‰๋œ ์บ ํŽ˜์ธ์ฝ”๋“œ
string
40
์„ค์น˜๋œ ํŒจํ‚ค์ง€๋ช…
string
10
๋ฐœ๊ธ‰๋œ ๋งค์ฒด์ฝ”๋“œ
string
40
๋งค์ฒด๋ณ„ ์œ ์ € ๊ณ ์œ  ์‹๋ณ„๊ฐ’
string
40
๊ตฌ๊ธ€๊ด‘๊ณ  ์•„์ด๋”” AdvertisingIdClient.Info idInfo = null; idInfo = AdvertisingIdClient.getAdvertisingIdInfo(mContext); return idInfo.getId();
string
40
iOS ๊ณ ์œ  ์‹๋ณ„์ž(IOS์ผ ๊ฒฝ์šฐ๋งŒ)
string
20
๋””๋ฐ”์ด์Šค ์•„์ด๋”” TelephonyManager mngr = (TelephonyManager)mContext.getSystemService(Context.TELEPHONY_SERVICE); return mngr.getDeviceId();
string
100
๊ตฌ๊ธ€ ๊ณ„์ • SHA1๋กœ ์ธ์ฝ”๋”ฉ ํ•œ๊ฒƒ์„ ๋‹ค์ค‘์ผ ๊ฒฝ์šฐ , ๋กœ ์—ฐ๊ฒฐํ•˜์—ฌ ์ฃผ์„ธ์š” Account[] accounts = AccountManager.get(mContext).getAccounts();
string
40
์•ˆ๋“œ๋กœ์ด๋“œ ์•„์ด๋”” return Settings.Secure.getString(mContext.getContentResolver(), Settings.Secure.ANDROID_ID);
string
40
๋ธŒ๋žœ๋“œ return Build.BRAND;
string
40
๋ชจ๋ธ return Build.MODEL;
string
20
์‚ฌ์šฉ์ž IP
3-4) Response Data
Search
Param
Type
Desc
string
๊ฒฐ๊ณผ (S: ์„ฑ๊ณต,E*: ์—๋Ÿฌ) E1 : ์ฐธ์—ฌ ๋Œ€์ƒ ์•„๋‹˜ E2 : ์ž˜๋ชป๋œ ์ ‘๊ทผ E3 : ์ข…๋ฃŒ๋œ ์ด๋ฒคํŠธ E4 : ๊ธˆ์ผ ์ฐธ์—ฌ๊ฐ€ ๋งˆ๊ฐ E5 : ์ด๋ฏธ ์ฐธ์—ฌํ–ˆ๋˜ ์ด๋ฒคํŠธ E6 : ๋‹ค๋ฅธ ๊ฒฝ๋กœ๋กœ ์ฐธ์—ฌํ–ˆ๋˜ ์ด๋ฒคํŠธ E7 : ๊ด‘๊ณ  ์ ‘์†์— ์‹คํŒจ E8 : ์ œํœด์‚ฌ๋กœ๋ถ€ํ„ฐ ์‘๋‹ต์š”์ฒญ์ด ์ง€์—ฐ E9 : ์„ค์น˜ํ•œ ๋‚ด์—ญ์ด ์กด์žฌ E10 : ์ง„ํ–‰ ์ค‘ ์ด์ง€ ์•Š์€ ๊ด‘๊ณ  E100 : ๊ธฐํƒ€ E101 : ์ƒํ’ˆ์ •๋ณด๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค. E102 : CPI ์ƒํ’ˆ์ด ์•„๋‹™๋‹ˆ๋‹ค. E103 : ํ•„์ˆ˜ ์ •๋ณด ๋ถ€์กฑ E104 : OS ํƒ€์ž…์ด ๋‹ค๋ฆ…๋‹ˆ๋‹ค.
string
์—๋Ÿฌ๋ฉ”์„ธ์ง€

4) ์ฐธ์—ฌ์™„๋ฃŒ Callback

โ˜‘ http://๋งค์ฒด์‚ฌ callback
4-1) Content Type
content-type=text/html;charset=UTF-8
4-2) Send Parameter Information
HTTP Method : - GET, POST, POST(JSON)
๋งค์ฒด ์–ด๋“œ๋ฏผ์—์„œ ์„ค์ •ํ•˜์‹ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
param : ์ „์†ก๋ฐ›์œผ์‹ค ํฌ์ŠคํŠธ๋ฐฑ ๋ณ€์ˆ˜๋ฅผ ์„ค์ • ๊ฐ€๋Šฅ
Search
Param
Macro
Type
Desc
{ads_idx}
int
๊ด‘๊ณ ๋ฒˆํ˜ธ
{ads_type}
int
๊ด‘๊ณ ํ˜•์‹(1: CPI, 2: CPE, 3: CPA, 4: CPS, 6: CPC, 7: CPSNS, 8: ๋‰ด์Šค ํ”ผ๋“œ ์ ๋ฆฝํ˜•)
{ads_name}
string
๊ด‘๊ณ ๋ช…
{rwd_cost}
int
๋ฆฌ์›Œ๋“œ๊ธˆ์•ก
{etc}
string
๋งค์ฒด์šฉ ์ถ”๊ฐ€์ •๋ณด (๋งค์ฒด uniq ํด๋ฆญ๊ฐ’ ๋“ฑ)
{app_uid}
string
๋งค์ฒด์‚ฌ์—์„œ ๋ณด๋‚ธ app_uid ๊ฐ’
{gp_key}
string
๊ทธ๋ฆฐํ”ผ ์ „ํ™˜ํ‚ค ๊ฐ’
{rwd_date}
date
์ „ํ™˜์ผ์ž(0000-00-00 00:00:00)
{adid_or_idfa}
string
adid or idfa
{ads_re_participate}
string
Y: ์ค‘๋ณต์ง€๊ธ‰๊ฐ€๋Šฅ N: ์ค‘๋ณต์ง€๊ธ‰๋ถˆ๊ฐ€

5) ์œ ์ € ์ฐธ์—ฌ ๊ด‘๊ณ  ๋ชฉ๋ก

5-1) Content Type
content-type=text/html;charset=UTF-8
5-2) Request Parameter Information
HTTP Method : - POST, GET
Search
Param
Type
Size
Desc
string
20
๋ฐœ๊ธ‰๋œ ๋งค์ฒด์ฝ”๋“œ
string
40
๋งค์ฒด ํŒŒํŠธ๋„ˆ ๊ณ ์œ ์•„์ด๋””
string
40
๊ตฌ๊ธ€๊ด‘๊ณ  ์•„์ด๋””
string
40
iOS ๊ณ ์œ  ์‹๋ณ„์ž(IOS์ผ ๊ฒฝ์šฐ๋งŒ)
date
0000-00-00(default: ์˜ค๋Š˜ ๋‚ ์งœ)
date
0000-00-00(default: ์˜ค๋Š˜ ๋‚ ์งœ)
5-3) Response Format
Output : JSON
{ "rst": "S", "msg": "", "data": [ { "ads_idx": 32049, "ads_name": "์ฟ ํŒก ๋ฐฉ๋ฌธํ•˜๊ธฐ" }, { "ads_idx": 26079, "ads_name": "์Šคํฌํ‚ค ํ”„๋กœ์•ผ๊ตฌ ์ƒ์ค‘๊ณ„ (๋ณด๋Ÿฌ๊ฐ€๊ธฐ/Visit)" } ] }
5-4) Response Data
Search
Param
Type
Desc
string
S : ์„ฑ๊ณต E100 : ๊ธฐํƒ€ E103 : ํ•„์ˆ˜ ์ •๋ณด ๋ถ€์กฑ E107: ๋“ฑ๋ก๋˜์ง€ ์•Š์€ ๋งค์ฒด์ž…๋‹ˆ๋‹ค.
string
์—๋Ÿฌ๋ฉ”์„ธ์ง€
string
ads_idx : ๊ด‘๊ณ ๋ฒˆํ˜ธ ads_name : ๊ด‘๊ณ ๋ช…

6) CS ๋ฌธ์˜ํ•˜๊ธฐ

Search
url
method
enctype
6-1) Request Parameter Information
HTTP Method : - GET, POST
Search
Param
Type
Size
Desc
string
20
๋ฐœ๊ธ‰๋œ ๋งค์ฒด์ฝ”๋“œ
string
40
๋งค์ฒด ํŒŒํŠธ๋„ˆ ๊ณ ์œ ์•„์ด๋””
string
40
๊ตฌ๊ธ€๊ด‘๊ณ  ์•„์ด๋””
string
40
iOS ๊ณ ์œ  ์‹๋ณ„์ž(IOS์ผ ๊ฒฝ์šฐ๋งŒ)
int
11
๊ด‘๊ณ ๋ฒˆํ˜ธ
int
11
๋ฌธ์˜์œ ํ˜•(1: ๊ด‘๊ณ ์ ๋ฆฝ๋ฌธ์˜, 2: ๊ธฐํƒ€๋ฌธ์˜)
string
255
cs ๋‚ด์šฉ
string
14
์—ฐ๋ฝ์ฒ˜
string
100
์ด๋ฉ”์ผ
string
50
์„ฑ๋ช…
์ฒจ๋ถ€ํŒŒ์ผ
6-2) Response Format
Output : JSON
{ "rst": "S", "msg": "CS ๋ฌธ์˜๊ฐ€ ๋“ฑ๋ก๋˜์—ˆ์Šต๋‹ˆ๋‹ค.", "idx": 123, } { "rst": "E100", "msg": "CS ๋ฌธ์˜๊ฐ€ ๋“ฑ๋ก์— ์‹คํŒจํ•˜์˜€์Šต๋‹ˆ๋‹ค. ๊ณ ๊ฐ์„ผํ„ฐ๋กœ ๋ฌธ์˜ํ•ด์ฃผ์„ธ์š”.โ€ }
6-3) Response Data
Search
Param
Type
Desc
string
S : ์„ฑ๊ณต E100 : ๊ธฐํƒ€
string
์—๋Ÿฌ๋ฉ”์„ธ์ง€
int
๋ฌธ์˜๋ฒˆํ˜ธ

7) CS ๋ฌธ์˜ ๋ฆฌ์ŠคํŠธ

7-1) Request Parameter Information
HTTP Method : - GET, POST
Search
Param
Type
Size
Desc
string
20
๋ฐœ๊ธ‰๋œ ๋งค์ฒด์ฝ”๋“œ
string
40
๋งค์ฒด ํŒŒํŠธ๋„ˆ ๊ณ ์œ ์•„์ด๋””
string
40
๊ตฌ๊ธ€๊ด‘๊ณ  ์•„์ด๋””
string
40
iOS ๊ณ ์œ  ์‹๋ณ„์ž(IOS์ผ ๊ฒฝ์šฐ๋งŒ)
date
0000-00-00(default: ์˜ค๋Š˜ ๋‚ ์งœ)
date
0000-00-00(default: ์˜ค๋Š˜ ๋‚ ์งœ)
7-2) Response Format
Output : JSON
{ "rst": "0", "msg": "", "data": [ { "q_idx": "2059", "ads_idx": "32049", "ads_name": "์ฟ ํŒก ๋ฐฉ๋ฌธํ•˜๊ธฐ", "ads_icon_img": "https://img.greenp.kr/cpi/16830989809977.png", "ads_summary": "[์ฐธ์—ฌ๋ฐฉ๋ฒ•] \r\\n\"์ฟ ํŒก\" ์— ๋ฐฉ๋ฌธํ•˜๊ณ  ๋ฆฌ์›Œ๋“œ๋ฅผ ์ ๋ฆฝ ๋ฐ›์œผ์„ธ์š”.\r\\n\r\\n[์•ฑ ์„ค๋ช…]\r\\n- ๋ฐค 12์‹œ ์ „๊นŒ์ง€ ์ฃผ๋ฌธ, ๋‹ค์Œ๋‚  ๋กœ์ผ“๋ฐฐ์†ก\r\\n- ์™€์šฐ๋ฉค๋ฒ„์‹ญ ํšŒ์›์€ ๋ฌด์กฐ๊ฑด ๋ฌด๋ฃŒ๋ฐฐ์†ก\r\\n- ๋ชจ๋“  ์‹ ์„ ์‹ํ’ˆ 8์‹œ๊ฐ„ ๋‚ด ๋ฐฐ์†ก, ๋กœ์ผ“ํ”„๋ ˆ์‹œ\r\\n- ํ• ์ธ ๋˜ ํ• ์ธ, ์™€์šฐ๋ฉค๋ฒ„์‹ญ ์ถ”๊ฐ€ ํ• ์ธ\r\\n- ๋ฏฟ์„ ์ˆ˜ ์žˆ๋Š” ํ•ด์™ธ ์‡ผํ•‘ ์‰ฝ๊ณ  ๋น ๋ฅธ ๋กœ์ผ“ ์ง๊ตฌ", "ads_reward_price": 360, "ads_price_type": "C", "app_uid": "media_user", "q_mobile": "01012345678", "q_name": "ํ™๊ธธ๋™", "q_con": "[๋ฌธ์˜์œ ํ˜•] ๊ด‘๊ณ ์ ๋ฆฝ ๋ฌธ์˜\n[์ฐธ์—ฌ์ผ] 2023-05-10 06:23:53\n[๋‹ต๋ณ€ ์ด๋ฉ”์ผ] hongildong@gmail.com\n[๋ฌธ์˜๋‚ด์šฉ] ์ฟ ๋ฐฉ. ํ™ˆํŽ˜์ด์ง€ ์— ๋ฐฉ๋ฌธ ํ–ˆ๋Š”๋ฐ์š” ๋ฆฌ์›Œ๋“œ ๊ฐ€ ์•ˆ๋˜์š”", "q_regdate": "2023-04-04 17:29:26", "q_status": "R", "q_ans_con": "", "q_ansdate": "0000-00-00 00:00:00โ€ } ] }
7-3) Response Data
Search
Param
Type
Desc
string
S : ์„ฑ๊ณต E100 : ๊ธฐํƒ€
string
์—๋Ÿฌ๋ฉ”์„ธ์ง€
string
q_idx : ๊ณ ์œ ๋ฒˆํ˜ธ,ย  ads_idx : ๊ด‘๊ณ ๋ฒˆํ˜ธ, ads_name: ๊ด‘๊ณ ๋ช…,ย  ads_icon_img: ์•„์ด์ฝ˜ ์ด๋ฏธ์ง€,ย  ads_summary: ์บ ํŽ˜์ธ์„ค๋ช…,ย  ads_reward_price: ๋ฆฌ์›Œ๋“œ๊ธˆ์•ก,ย  ads_price_type: ํฌ์ธํŠธ๋ช… app_uid: ์‚ฌ์šฉ์žID,ย  q_mobile: ์—ฐ๋ฝ์ฒ˜,ย  q_name: ์„ฑ๋ช…,ย  q_con: CS ๋‚ด์šฉ, q_regdate: ๋“ฑ๋ก์ผ์ž,ย  q_status: ์ฒ˜๋ฆฌ์ƒํƒœ,ย  q_ans_con: CS ๋‹ต๋ณ€๋‚ด์šฉ,ย  q_ansdate: CS ๋‹ต๋ณ€์ผ์ž