---
# System prepended metadata

title: 必盈API
tags: [API, 必盈]

---

# 目錄
[TOC]

# 查看標的種類
`https://fintech.i-recu.com/api/target`
查看標的種類與編號。

## 回傳
`json`

```json=
[
    {
        id: "2",
        target: "期貨-小台"
    },
    {
        id: "1",
        target: "期貨-大台"
    }
]
```


# 建立收益
`https://fintech.i-recu.com/api/profit`
建立會員標的的每日收益資料。
每個身分證同一個標的一天只能建立一筆收益資料，如果資料輸入錯誤可以至系統後台手動更改；
或設置`modify`參數為`1`來開啟編輯功能，開啟後可以變更該筆收益資料的收益金額。

## 參數
`GET`

id_number `str` `必填`
: 身分證字號。

target `int` `必填`
: 標的種類編號。 參考[查看標的種類](#查看標的種類)

date `0000-00-00`
: 收益日期。

profit `int` `必填`
: 收益金額。

modify `int` `選填`
: `1=>可編輯` ` 0=>不可編輯(預設)`
編輯功能。當該日期已建立標的收益資料時，是否修改資料。設置後可以修改收益金額。

check_sum `str` `必填`
: 驗證碼。
將 `api_key`、`id_number`、recu2023、`target_item`、fintech、`date`、gogogo、`profit` 以上參數和文字按照順序組合後再通過md5加密後取得。
```php!
php
$check_sum = md5("{$api_key}{$id_number}recu2023{$target_item}fintech{$date}gogogo{$profit}");
```

## 回傳
`json`

```json=
{
    type: "success",
    message: "儲存成功"
}
```
