# 邀請好友

---
- API 清單
- WEB端
- [好友邀請綁定](#好友邀請綁定)
- APP端
- [我的邀請碼](#我的邀請碼)
---

## 好友邀請綁定

POST /invitation/bind

### Request
欄位 | 型態 | 必填 | 長度限制 | 預設 | 說明
---|---|---|---|---|---
inviteCode | string | Y | 36 | | 邀請碼, 目前為5碼大寫英文字母
countryCode | string | Y | 5 | | 電話國碼, e.g.台灣為+886
phone | string | Y | 20 | | 手機號碼(台灣手機號碼格式09.....)

 {
    "inviteCode": "YKDXW",
    "countryCode": "+886",
    "phone": "0912345678"
}

### Error
httpCode | 錯誤碼 | 說明
--- | --- | ---
400 | API_ERROR.NOT_EXIST | 無此筆資料
400 | API_ERROR.ARGUMENT_ERROR | 輸入參數錯誤, 可參閱 errorDesc
422 | SERVICE_ERROR.INVITATION_HAD_BEEN_MEMBER | 已是註冊會員
422 | SERVICE_ERROR.INVITATION_HAD_BIND | 已綁定過好友

### Response
欄位 | 型態 | 說明
--- | --- | ---
id | string | 綁定id

 {
     "httpCode": 200,
     "result": {
         "data": {
             "id": "f783d4cd-f6e4-40e4-845a-44b227b71f2a"
         }
     }
 }

## 我的邀請碼

GET /invitation/my-invite-code

### Request
欄位 | 型態 | 必填 | 長度限制 | 預設 | 說明
---|---|---|---|---|---

### Response
欄位 | 型態 | 說明
--- | --- | ---
inviteCode | string | 邀請碼, 目前為5碼大寫英文字母
inviteUrl | string | 邀請好友網址
points | int | 邀請好友可獲得點數

  {
      "httpCode": 200,
      "result": {
          "data": {
              "inviteCode": "YKDXW",
              "inviteUrl": "https://care.health365.net/#/invitations/YKDXW",
              "point": 150
          }
      }
  }