---
# System prepended metadata

title: 邀請好友

---

# 邀請好友

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


## 好友邀請綁定

```url
POST /invitation/bind
```

### Request
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明 
 ---|---|---|---|---|---
 inviteCode | string | Y | 36 | | 邀請碼, 目前為5碼大寫英文字母
 countryCode | string | Y | 5 | | 電話國碼, e.g.台灣為+886
 phone | string | Y | 20 | | 手機號碼(台灣手機號碼格式09.....)
 
 ```javascript
 {
    "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
 
 ```javascript
 {
     "httpCode": 200,
     "result": {
         "data": {
             "id": "f783d4cd-f6e4-40e4-845a-44b227b71f2a"
         }
     }
 }
 ``` 


## 我的邀請碼

```url
GET /invitation/my-invite-code
```

### Request
 欄位 | 型態  | 必填 | 長度限制 | 預設 | 說明 
 ---|---|---|---|---|---
 
 
 ### Response
  欄位 | 型態 | 說明 
  ---  | --- | ---
  inviteCode | string | 邀請碼, 目前為5碼大寫英文字母
  inviteUrl | string | 邀請好友網址
  points | int | 邀請好友可獲得點數
  
  ```javascript
  {
      "httpCode": 200,
      "result": {
          "data": {
              "inviteCode": "YKDXW",
              "inviteUrl": "https://care.health365.net/#/invitations/YKDXW",
              "point": 150
          }
      }
  }
  ``` 

