๐ฃ ์ด๋ณด์๋ฅผ ์ํ UnivCert์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฌ์ฉ๋ฒ์ ํด๋น ์ฌ์ดํธ์ ๊ธฐ์ฌ๋์ด ์์ต๋๋ค.
์ ์ฒด ๊ตฌ์ฑ๋
์ค ์ ์ฉ ์ฌ๋ก
๐ก API ์ค๋ช
Request
key
: ๋ถ์ฌ๋ฐ์ API_KEY
univName
: ๋ํ๊ต๋ช
email
: ์ด์ฉ์ ์ด๋ฉ์ผ
univ_check
: ๋ํ ์ฌํ ์ฌ๋ถ(๋๋ฉ์ธ) ์ฒดํน [boolean]
(true๋ผ๋ฉด ํด๋น ๋ํ ์ฌํ ์ฌ๋ถ, false๋ผ๋ฉด ๋ฉ์ผ ์์ ์ธ์ฆ๋ง)
code
: ์ ์ก๋ ์ธ์ฆ๋ฒํธ (4์๋ฆฌ)
Response
success
: API ํต์ ์ฑ๊ณต ์ฌ๋ถ
message
: success๊ฐ false ์์ ์ ๋ฌ๋๋ ์ค๋ฅ ๋ฉ์์ง
certified_email
: ์ธ์ฆ๋ ์ด๋ฉ์ผ
certified_date
: ํด๋น ๋ฉ์ผ์ด ์ธ์ฆ๋ ์ผ์
data
: jsonArray List ์ถ๋ ฅ๊ฐ
[POST] univcert.com/api/v1/certify ์์ฒญ
์ด์ฉ์ ๋ฉ์ผ ์ธ์ฆ ์์ !
{
โkeyโ : โ๋ถ์ฌ๋ฐ์ API KEYโ,
"emailโ : โ[email protected]โ,
โunivNameโ : โํ์ต๋ํ๊ตโ,
โuniv_checkโ : true
(true๋ผ๋ฉด ํด๋น ๋ํ ์ฌํ ์ฌ๋ถ, false๋ผ๋ฉด ๋ฉ์ผ ์์ ์ธ์ฆ๋ง)
}
[POST] univcert.com/certify ์๋ต
response (๋ฉ์ผ ์ธ์ฆ๋ฒํธ 4์๋ฆฌ ์ ์ก ์ฑ๊ณต)
{
โsuccessโ : true
}
response (์คํจ)
{
"status" : 400,
"success" : false,
"message" : ํ๋จ ๋ฉ์์ง ํ ์ฐธ๊ณ
}
- ์๋ฌ ๋ฉ์์ง (์ด์ )
- ์๋ชป๋ ํ๋ผ๋ฏธํฐ ์ ๋ ฅ
- ์๋ชป๋ ์ด๋ฉ์ผ ํ์ (๋จ์ ์๋ ํ์ ์ถ๋ ฅ MAX = 3)
- ์ผ์ผ ์๋ ๊ฐ๋ฅ ํ์ ์ด๊ณผํ ์ด๋ฉ์ผ
- (univ_check = true ์์) ๋ํ ๋๋ฉ์ธ๊ณผ ๋ถ์ผ์น
- ์ด๋ฏธ ์ธ์ฆ๋ ์ด๋ฉ์ผ
- ์กด์ฌํ์ง ์๋ API_KEY.
[POST] univcert.com/certifycode ์์ฒญ
์ด์ฉ์ ๋ฉ์ผ์ ๋ฐ์ก๋ ์ธ์ฆ์ฝ๋๋ฅผ ์ ๋ฌ๋ฐ์ ์์ฒญํ๊ธฐ
{
โkeyโ : โ๋ถ์ฌ๋ฐ์ API KEYโ
โunivNameโ : โํ์ต๋ํ๊ตโ,
โemailโ : "**[email protected]**โ,
โcodeโ : 3816
}
[POST] univcert.com/certifycode ์๋ต
response (์ธ์ฆ๋ฒํธ ์ผ์น์)
{
โsuccessโ : true,
โunivNameโ : โํ์ต๋ํ๊ตโ,
โcertified_emailโ : โ[email protected]โ,
โcertified_dateโ : โ2023-01-03T09:30:22โ
}
response (์คํจ)
{
"status" : 400
โsuccessโ : false,
โmessageโ : ํ๋จ ๋ฉ์์ง ์ฐธ๊ณ
}
- ์๋ฌ ๋ฉ์์ง
- ์๋ชป๋ ํ๋ผ๋ฏธํฐ ์ ๋ ฅ
- ์๋ชป๋ ์ด๋ฉ์ผ ํ์
- ์ธ์ฆ ์์ฒญ ์ด๋ ฅ์ด ์๋ ์ด๋ฉ์ผ.
- ์ธ์ฆ๋ฒํธ ๋ฏธ์ผ์น
- ์กด์ฌํ์ง ์๋ API_KEY.
[POST] univcert.com/status ์์ฒญ
์ธ์ฆ๋ ์ด๋ฉ์ผ์ธ์ง ์ฒดํน ๊ธฐ๋ฅ
request
{
โkeyโ : โ๋ถ์ฌ๋ฐ์ API KEYโ,
"emailโ : โ[email protected]โ
}
[POST] univcert.com/status ์๋ต
response
{
โsuccessโ : true,
โcertified_dateโ : โ2023-01-03T09:30:22โ
}
response (์คํจ)
{
โsuccessโ : false,
โmessageโ : ํ๋จ ๋ฉ์์ง ์ฐธ๊ณ
}
- ์๋ฌ ๋ฉ์์ง
- ์๋ชป๋ ํ๋ผ๋ฏธํฐ ์ ๋ ฅ
- ์๋ชป๋ ์ด๋ฉ์ผ ํ์
- ์ธ์ฆ ์์ฒญ ์ด๋ ฅ์ด ์๋ ์ด๋ฉ์ผ์ ๋๋ค.
- ์ธ์ฆ์ฝ๋๋ฅผ ์ ๋ ฅํด์ผ ๋๋ ๋จ๊ณ์ ๋๋ค.
- ์กด์ฌํ์ง ์๋ API_KEY.
[Post] univcert.com/certifiedlist ์์ฒญ
์ธ์ฆ๋ ์ ์ ๋ฆฌ์คํธ ์ถ๋ ฅ
request
{
โkeyโ : โ๋ถ์ฌ๋ฐ์ API KEYโ
}
[Post] univcert.com/certifiedlist ์๋ต
response
{
"data": [
{
"email": "[email protected]",
"univName": "ํ์ต๋ํ๊ต",
"certified_date" : "2023-01-26T04:52:04.179837"
"count": 1,
"certified": true
},
{
...
}
],
"success": true
}
response (์คํจ)
{
"status" : 400
โsuccessโ : false,
โmessageโ : ํ๋จ ๋ฉ์์ง ์ฐธ๊ณ
}
- ์๋ฌ ๋ฉ์์ง
- ์๋ชป๋ ํ๋ผ๋ฏธํฐ ์ ๋ ฅ
- ์๋ชป๋ ์ด๋ฉ์ผ ํ์
- ์กด์ฌํ์ง ์๋ API_KEY.
[POST] univcert.com/check ์์ฒญ
์ธ์ฆ ๊ฐ๋ฅํ ๋ํ๋ช
์ธ์ง ์ฒดํน
request
{
"univName" : "ใ
ใ
๋ํ๊ต"
}
[Post] univcert.com/check ์๋ต
response
{
"success": true
}
response (์คํจ)
{
"status" : 400
โsuccessโ : false,
โmessageโ : ํ๋จ ๋ฉ์์ง ์ฐธ๊ณ
}
- ์๋ฌ ์ด์
- ์๋ฒ์ ์กด์ฌํ์ง ์๋ ๋ํ๋ช ( 22๋ ๊ธฐ์ค ์ ํ์ ์์ 120๊ฐ ๋ํ)
- ๋ํ๋ช ํ์ ์ค๋ฅ (~~๋ํ๊ต)
5/20 ์ถ๊ฐ !
[Post] univcert.com/clear ์์ฒญ
ํ์ฌ ์ธ์ฆ ๋ ์ ์ ๋ชฉ๋ก ์ด๊ธฐํ
request
{
โkeyโ : โ๋ถ์ฌ๋ฐ์ API KEYโ
}
[Post] univcert.com/clear ์๋ต
response
{
"success": true
}
์ํ์ฝ๋ ๋ฐํ ํ
CODE | DESCRIPTION |
---|---|
200(Success) | ์ฑ๊ณต. |
400(Bad Request) | ์๋ชป๋ ์์ฒญ (์์ฒญ ๊ฐ ํ์, ํ์ ์ค๋ฅ, ์กด์ฌํ์ง ์๋ ์ด๋ฉ์ผ โฆ) |
500(Server error) | ์๋ฒ ์ธก ์๋ฌ. ์ต๋ํ ๋ ธ๋ ฅํด๋ณด๊ฒ ์ต๋๋ค.. |