Albamon 兼职地图、Albamon Z 与 Gigmon 数据 API

알바몬（Albamon）是 Workspear（웍스피어）面向韩国小时工与兼职아르바이트市场的 Android 应用。求职者用 Albamon 账号或 Kakao、Naver、Facebook、Google、Apple 登录，在 Naver 地图上找附近班次、收藏 scrap、按市/区/洞与工期/工作日/工时设首页筛选，并填写覆盖地点、职种与期望排班的 Albamon Z 匹配简历。加盟店与雇主在同一张地图上关注 interest-corporation 图钉；Gigmon 是应用内零工聊天与短单交易层。它是 Jobkorea 的小时工姊妹产品，面向学生、受未成年限制的青少年，以及零售、餐饮与物流短期알바，而不是白领职业社交。

每枚地图图钉会展开成以 recruitNo 为键的兼职卡片，带上 companyName、时薪 pay/payType、workplaceAddress、closingDDay 以及 useAlbamonZ 标记。

首页筛选持久化韩国 cityCode/countyCode/townCode 与 workPeriodTypes、地图 radius；Albamon Z 简历给出 resumeNo、wishWorkTimes 和匹配 key/value，Gigmon 聊天卡片再补上 talent_No、trade_No 与 trade_Stat_Code。劳动力看板可叠加街区알바密度，HR 工具可盯匹配与关注企业文件夹，市场机器人可跟踪短单交易状态——openData Studio 把这些字段变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

会员登录会话

POST /v1/members/session osint

登录个人、加盟店或社交会员，返回后续职位与 Gigmon 调用所用的 accessToken、memberNo、minorOfLaw 与 gigmonMemberNo。

认证方式：无需先验会话。请求头 AM_App_No=17、Key_No、App_Ver、App_VerCode。响应写入会话 Cookie（mapp_nid、appnewid）并返回后续调用所用的 accessToken。

accessToken
age
agreeCollectionAndUsePersonalInfoForMarketing
agreeReceiveEmailAndSms
appLoginKey
birthDay
certificationStatus
email
genderType
gigmonMemberNo
loginTime
formattedLoginTime
memberId
memberName
memberNo
memberType
minorOfLaw
snsType
franchiseBrandCode
franchiseStoreCode
franchiseStoreName
captchaKey

POST /v1/members/session HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Key_No: <app-key>
App_Ver: 5.4.20
App_VerCode: 301

{
  "memberId": "seeker01",
  "memberPassword": "********",
  "memberType": "PERSONAL",
  "captchaKey": ""
}

{
  "accessToken": "eyJhbGciOiJIUzI1NiJ9.example",
  "age": 24,
  "agreeCollectionAndUsePersonalInfoForMarketing": false,
  "agreeReceiveEmailAndSms": true,
  "appLoginKey": "alk_9f2a",
  "birthDay": "2001-04-12",
  "certificationStatus": true,
  "email": "[email protected]",
  "genderType": {"description": "여성", "key": "W", "value": 2},
  "gigmonMemberNo": "882145",
  "loginTime": "2026-10-02T09:14:22+09:00",
  "formattedLoginTime": "2026.10.02 09:14",
  "memberId": "seeker01",
  "memberName": "김민지",
  "memberNo": 4412891,
  "memberType": {"description": "개인회원", "key": "PERSONAL", "value": "PERSONAL"},
  "minorOfLaw": false,
  "snsType": {"description": "카카오", "key": "KAKAO", "value": "KAKAO"},
  "franchiseBrandCode": null,
  "franchiseStoreCode": null,
  "franchiseStoreName": null
}

首页职位筛选

GET /v1/home/filter-set opendata

读取首页已保存筛选：韩国行政区、职种代码、工期/工作日/工时窗口，以及可选地图半径。

认证方式：会话 Cookie mapp_nid / appnewid，以及 AM_App_No、Key_No、App_Ver、App_VerCode 头。登录后可附带 accessToken。

id
condition
commonCondition
areas
cityCode
countyCode
townCode
parts
categoryCode
code
excludeBar
workPeriodTypes
workWeekTypes
workDayTypes
excludeNegoWorkWeek
workTimeTypes
startWorkTime
endWorkTime
excludeNegoWorkTime
areaSearchType
map
latitude
longitude
radius
name

GET /v1/home/filter-set HTTP/1.1
AM_App_No: 17
Key_No: <app-key>
App_Ver: 5.4.20
App_VerCode: 301
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json

{
  "id": "cond_home_1",
  "condition": {
    "commonCondition": {
      "areas": [{"cityCode": "11", "countyCode": "110", "townCode": "1101"}],
      "parts": [{"categoryCode": "SVC", "code": "CS010"}],
      "excludeBar": true,
      "workPeriodTypes": ["SHORT"],
      "workWeekTypes": ["WEEKDAY"],
      "workDayTypes": ["MON", "TUE", "WED", "THU", "FRI"],
      "excludeNegoWorkWeek": false,
      "workTimeTypes": ["EVENING"],
      "startWorkTime": "18:00",
      "endWorkTime": "23:00",
      "excludeNegoWorkTime": false,
      "areaSearchType": "AREA",
      "map": {"latitude": 37.5665, "longitude": 126.9780, "radius": 2000, "name": "서울 중구"}
    }
  }
}

搜索建议

GET /v1/search/suggest opendata

关键词搜索界面的联想：每条命中带 keyword、featureCode、featureName 与深链 url。

认证方式：会话 Cookie 加上 AM_App_No、Key_No、App_Ver、App_VerCode 头。

keyword
suggestions
featureCode
featureName
url
size
mobile

GET /v1/search/suggest?keyword=%EC%BB%A4%ED%94%BC&size=8&mobile=true HTTP/1.1
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json

{
  "keyword": "커피",
  "suggestions": [{
    "keyword": "커피전문점",
    "featureCode": "PART",
    "featureName": "직종",
    "url": "/search?keyword=%EC%BB%A4%ED%94%BC%EC%A0%84%EB%AC%B8%EC%A0%90"
  }]
}

坐标转行政区代码

POST /v1/geo/admin-areas opendata

把 GPS 点解析为韩国市/区/洞 type-code 对，用于填充首页筛选的 areas 列表。

认证方式：会话 Cookie 加上 AM_App_No、Key_No、App_Ver、App_VerCode 头。

latitude
longitude
content
type
code

POST /v1/geo/admin-areas HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>

{
  "latitude": 37.5665,
  "longitude": 126.9780
}

{
  "content": [
    {"type": "CITY", "code": "11"},
    {"type": "COUNTY", "code": "110"},
    {"type": "TOWN", "code": "1101"}
  ]
}

地图职位卡片

POST /v1/map/shift-cards opendata

把地图选中的 recruitNos 展开为职位卡片：标题、时薪、工作地点坐标、截止 D-day 与 Albamon Z 资格。

认证方式：会话 Cookie 与 AM_App_No 头。登录后附带 POST /v1/members/session 下发的 accessToken。

collection
recruitNo
recruitTitle
companyId
companyName
logoUrl
latitude
longitude
distanceToWorkplace
workplaceAddress
workplaceArea
pay
payType
parts
workingPeriod
workingWeek
workingTime
closingDDay
closingDate
postedDate
scraped
existsMap
useAlbamonZ
managerPhoneNumber
postStatusType
recruitType
recruitListType
wishAreaNo
recruitNos

POST /v1/map/shift-cards HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>

{
  "recruitListType": "MAP",
  "wishAreaNo": 11,
  "recruitNos": [88214501, 88214502]
}

{
  "collection": [{
    "recruitNo": 88214501,
    "recruitTitle": "주말 카페 홀서빙",
    "companyId": "C009918",
    "companyName": "한강커피",
    "logoUrl": "https://cdn.example.org/logo/c009918.png",
    "latitude": 37.5210,
    "longitude": 126.9240,
    "distanceToWorkplace": 420,
    "workplaceAddress": "서울 영등포구 여의동",
    "workplaceArea": "여의도",
    "pay": "11000",
    "payType": {"description": "시급", "key": "HOURLY", "value": 1},
    "parts": ["외식·음료"],
    "workingPeriod": "단기",
    "workingWeek": "주말",
    "workingTime": "10:00~18:00",
    "closingDDay": 5,
    "closingDate": "2026-10-08",
    "postedDate": "2026-09-28",
    "scraped": false,
    "existsMap": true,
    "useAlbamonZ": true,
    "managerPhoneNumber": "02-1234-5678",
    "postStatusType": {"description": "게재중", "key": "OPEN", "value": 1},
    "recruitType": {"description": "일반", "key": "NORMAL", "value": 0}
  }]
}

地图收藏开关

POST /v1/map/bookmark opendata

收藏或取消收藏地图职位；回执带回 corpName、职位名与 partName，供收藏提示使用。

认证方式：已登录会话 Cookie 与 POST /v1/members/session 下发的 accessToken。

recruitNo
scrap
corpName
empmntName
partName
resultCode
resultMessage
errorMessage

POST /v1/map/bookmark HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>

{
  "recruitNo": 88214501,
  "scrap": true
}

{
  "corpName": "한강커피",
  "empmntName": ["주말 카페 홀서빙"],
  "partName": ["외식·음료"],
  "resultCode": 0,
  "resultMessage": "OK",
  "errorMessage": null
}

附近热点

POST /v1/map/nearby-cluster opendata

告诉地图当前半径内是否有命名알바热点，并给出热点代码、名称、经纬度与箭头角度。

认证方式：会话 Cookie 与 AM_App_No 头。登录后可附带 accessToken。

latitude
longitude
radius
existsNearbyHotSpot
nearbyHotSpot
hCode
hName
hLatitude
hLongitude
hAngle
address

POST /v1/map/nearby-cluster HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>

{
  "latitude": "37.5665",
  "longitude": "126.9780",
  "radius": "1500"
}

{
  "existsNearbyHotSpot": true,
  "nearbyHotSpot": {
    "hCode": 1101,
    "hName": "명동",
    "hLatitude": 37.5636,
    "hLongitude": 126.9826,
    "hAngle": 45,
    "address": "서울 중구 명동"
  }
}

已保存搜索条件

GET /v1/search/saved-suit opendata

读取已保存맞춤（suit）搜索：si/gu/dong 区域、时薪区间、排除关键词与详细搜索界面所用的地图缩放。

认证方式：已登录会话 Cookie 与 POST /v1/members/session 下发的 accessToken。

condition
conditionId
recruitListType
suitNo
areas
si
gu
dong
parts
categoryCode
categoryName
payCondition
payType
moreThanWon
lessThanWon
startWorkTime
endWorkTime
workPeriodTypes
workWeekTypes
excludeBar
excludeKeywords
includeKeyword
map
latitude
longitude
radius
zoom
suit
suitTitle
albamonZ
excludeHomeWork
quickStart

GET /v1/search/saved-suit?recruitListType=MAP&suitNo=12 HTTP/1.1
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json

{
  "condition": {
    "conditionId": "suit_12",
    "recruitListType": "MAP",
    "areas": [{"si": "서울", "gu": "중구", "dong": "명동"}],
    "parts": [{"categoryCode": "SVC", "categoryName": "서비스", "code": "CS010", "name": "커피전문점"}],
    "payCondition": {"payType": "HOURLY", "moreThanWon": 10000, "lessThanWon": 15000, "payAddType": null},
    "startWorkTime": "18:00",
    "endWorkTime": "23:00",
    "workPeriodTypes": ["SHORT"],
    "workWeekTypes": ["WEEKEND"],
    "excludeBar": true,
    "excludeKeywords": ["유흥"],
    "includeKeyword": "카페",
    "map": {"latitude": 37.5665, "longitude": 126.9780, "radius": 2000, "zoom": 15},
    "suit": {"suitNo": 12, "suitTitle": "여의도 주말"},
    "albamonZ": {"excludeHomeWork": false},
    "quickStart": true
  }
}

Albamon Z 简历

GET /v1/matching/short-resume osint

返回求职者的 Albamon Z 匹配资料：resumeNo、偏好地点与职种、期望工时以及 notify/alarm 窗口。

认证方式：已登录会话 Cookie 与 POST /v1/members/session 下发的 accessToken。

resumeNo
locations
parts
skills
schedule
wishWorkTimes
workPeriodType
description
key
value
notify
alarm
alarmOff
alarmOffStartTime
alarmOffEndTime
step

GET /v1/matching/short-resume HTTP/1.1
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json

{
  "resumeNo": 55201,
  "locations": [{"cityCode": "11", "countyCode": "110"}],
  "parts": [{"categoryCode": "SVC", "code": "CS010"}],
  "skills": ["POS", "홀서빙"],
  "schedule": {
    "wishWorkTimes": ["18:00-23:00"],
    "workPeriodType": {"description": "단기", "key": "SHORT", "value": 1}
  },
  "notify": {
    "alarm": true,
    "alarmOff": false,
    "alarmOffStartTime": null,
    "alarmOffEndTime": null
  },
  "step": {"description": "작성완료", "key": "DONE", "value": 3}
}

Albamon Z 匹配状态
GET /v1/matching/ready-flag opendata
报告 Albamon Z 资料是否已完成必要匹配步骤（description/key/value 三元组）。
认证方式：已登录会话 Cookie 与 POST /v1/members/session 下发的 accessToken。
- description
- key
- value
```
GET /v1/matching/ready-flag HTTP/1.1
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json
```
```
{
  "description": "매칭 완료",
  "key": "MATCHED",
  "value": "DONE"
}
```

关注企业地图图钉

GET /v1/employers/followed-pins opendata

在关注企业地图上绘制已关注雇主：每个图钉带 companyId、经纬度、聚合 recruitList 与职位数量。

认证方式：已登录会话 Cookie 与 POST /v1/members/session 下发的 accessToken。

mTotalCount
mTotalPage
markerItem
orderNo
nameValue
code
latitudeValue
longitudeValue
partValue
url
count
recruitList
companyId
flag
isEvent
myLocationEnc
reqDateTime
ListUrl
myLocationStat
mapLat
mapLng
mapR
pinSize
isExcludeBar

GET /v1/employers/followed-pins?myLocationStat=1&mapLat=37.5665&mapLng=126.9780&mapR=2000&pinSize=40&isExcludeBar=true HTTP/1.1
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>
Accept: application/json

{
  "mTotalCount": 12,
  "mTotalPage": 1,
  "markerItem": [{
    "orderNo": 1,
    "nameValue": "한강커피 여의도점",
    "code": "C009918",
    "latitudeValue": 37.5210,
    "longitudeValue": 126.9240,
    "partValue": "CS010",
    "url": "/corp/C009918",
    "count": "3",
    "recruitList": [88214501, 88214507],
    "companyId": "C009918",
    "flag": 0,
    "isEvent": false
  }],
  "myLocationEnc": "enc-loc",
  "reqDateTime": "2026-10-02T09:20:00+09:00",
  "ListUrl": "/interest/list"
}

关注企业
POST /v1/employers/follow opendata
在关注企业文件夹中添加或更新雇主，并回报该公司的应用推送是否开启。
认证方式：已登录会话 Cookie 与 POST /v1/members/session 下发的 accessToken。
- companyId
- favoriteCorporationFolderNumber
- isFavoriteCorporation
- isFavoriteCorporationDefaultFolder
- isAppPushStatus
- resultCode
- resultMessage
```
POST /v1/employers/follow HTTP/1.1
Content-Type: application/json
AM_App_No: 17
Cookie: mapp_nid=<nid>; appnewid=<id>

{
  "companyId": "C009918",
  "favoriteCorporationFolderNumber": "1",
  "isFavoriteCorporation": true,
  "isFavoriteCorporationDefaultFolder": true
}
```
```
{
  "isAppPushStatus": true,
  "resultCode": 0,
  "resultMessage": "OK"
}
```
Gigmon 聊天访问令牌
POST /v1/gigs/chat-token osint
为 Albamon 登录载荷中的 gigmonMemberNo 签发 Gigmon 聊天 Bearer 令牌。
认证方式： Albamon 登录后的表单请求体。响应中的 accessToken 在后续 Gigmon 聊天与交易调用中作为 Bearer 发送。
- gigmonMemberNo
- accessToken
```
POST /v1/gigs/chat-token HTTP/1.1
Content-Type: application/x-www-form-urlencoded

gigmonMemberNo=882145
```
```
{
  "accessToken": "gm_tok_7f3a9c2e"
}
```

Gigmon 才艺聊天卡片

POST /v1/gigs/chat-card opendata

为聊天加载 Gigmon 零工卡片：才艺标题与图片、卖家标记、在线状态以及 trade_No / trade_Stat_Code。

认证方式：来自 POST /v1/gigs/chat-token 的 Bearer accessToken。表单 FieldMap 请求体。

talent_No
talent_Title
talent_Image
isSeller
talent_Stat_Code
talent_Stat_Message
talent_Stat_Sub_Message
person_Stat_Code
person_Stat_Message
trade_No
trade_Stat_Code
items

POST /v1/gigs/chat-card HTTP/1.1
Authorization: Bearer gm_tok_7f3a9c2e
Content-Type: application/x-www-form-urlencoded

talent_No=4412

{
  "talent_No": 4412,
  "talent_Title": "주말 전단지 배포",
  "talent_Image": "https://cdn.example.org/gigmon/4412.jpg",
  "isSeller": true,
  "talent_Stat_Code": "ON",
  "talent_Stat_Message": "거래가능",
  "talent_Stat_Sub_Message": "오늘 가능",
  "person_Stat_Code": "ONLINE",
  "person_Stat_Message": "접속중",
  "trade_No": 9901,
  "trade_Stat_Code": "START",
  "items": []
}

数据类别

职位列表
地图图钉
已保存搜索筛选
收藏
简历
匹配状态
关注雇主
身份
零工市场

数据使用场景与案例

带时薪与截止日的小时工地图
城市劳动力看板可按 recruitNo 连接地图职位卡片与工作地点经纬度、payType、closingDDay，再按街区叠加韩国알바密度。
Albamon Z 匹配盯盘
HR 工具可读取 resumeNo、wishWorkTimes 与匹配 key/value 状态，在求职者短简历对附近职种变为 MATCHED 时告警。
关注雇主图钉同步
招聘 CRM 可轮询关注企业图钉的 companyId、recruitList 与 isAppPushStatus，使已关注门店文件夹与求职者地图保持同步。
Gigmon 交易状态跟踪
市场机器人可盯 gig 聊天卡片上的 talent_No、trade_No 与 trade_Stat_Code，标记 START 与已取消的短单交易。

常见问题

Albamon 如何鉴权求职者？

POST /v1/members/session 返回 accessToken、memberNo、gigmonMemberNo 与 minorOfLaw，客户端存储会话 Cookie（mapp_nid、appnewid）。后续调用携带这些 Cookie 以及 AM_App_No、Key_No、App_Ver、App_VerCode。Gigmon 聊天另用 POST /v1/gigs/chat-token 下发的 Bearer。

地图职位卡片有哪些字段？

POST /v1/map/shift-cards 返回 collection 项，含 recruitNo、recruitTitle、companyName、pay 与 payType、workplaceAddress、经纬度、closingDDay、scraped 与 useAlbamonZ。

数据模型里的 Albamon Z 是什么？

GET /v1/matching/short-resume 是短匹配资料（resumeNo、locations、parts、wishWorkTimes、notify 闹钟窗口、step）。GET /v1/matching/ready-flag 用 description/key/value 标记该资料是否已完成匹配。

Gigmon 是否暴露零工交易状态？

POST /v1/gigs/chat-card 在签发 Gigmon 访问令牌后返回聊天卡片上的 talent_No、talent_Title、isSeller、person_Stat_Code、trade_No 与 trade_Stat_Code。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Albamon 兼职地图、Albamon Z 与 Gigmon 数据 API

应用截图

API 端点一览

会员登录会话

首页职位筛选

搜索建议

坐标转行政区代码

地图职位卡片

地图收藏开关

附近热点

已保存搜索条件

Albamon Z 简历

Albamon Z 匹配状态

关注企业地图图钉

关注企业

Gigmon 聊天访问令牌

Gigmon 才艺聊天卡片

数据类别

数据使用场景与案例

带时薪与截止日的小时工地图

Albamon Z 匹配盯盘

关注雇主图钉同步

Gigmon 交易状态跟踪

常见问题

更多招聘求职类应用

apna - Search Job, Vacancy App

Bumeran

Clickworker

Fiverr - Freelance Service

相关主题

需要集成这个 App 的数据 API？