☎️電話號碼

搜尋電話號碼

GET https://{API_DOMAIN}/api/v1/phone-number

curl -X GET
    -H "Content-Type: application/json"
    '{"type": 0, "number": "0928846763"}'
    https://{API_HOST}/api/v1/phone-number

Form Data

下表為可使用的過濾條件

PARAMETER	REQUIRED	DEFAULT	TYPE	DESCRIPTION
contact_id	false	NULL	Number	客戶的 id (可透過 搜尋客戶 取得客戶的 id)
type	false	NULL	Number	0: 住家, 1: 公司, 2: 手機, 3: 傳真, 4: 其他
number	false	NULL	String	電話號碼
extension	false	NULL	String	分機號碼
description	false	NULL	String	備註

Response

PROPERTY	TYPE	DESCRIPTION
data	Array of objects	電話號碼陣列
meta	Object	Pagination meta

{
    "data": [
        {
            "id": 245621,
            "type": 0,
            "extension": null,
            "number": "0928846763",
            "description": null,
            "profile_id": 1935008,
            "phone_contact": {
                "id": 480,
                "contact_id": 1935038,
                "phone_number_id": 245621,
                "is_visible": true
            }
        }
    ],
    "links": {
        "first": "https://firstline.localhost/api/phone-number?number=0928846763&contact_id=1935038&page=1",
        "last": "https://firstline.localhost/api/phone-number?number=0928846763&contact_id=1935038&page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://firstline.localhost/api/phone-number",
        "per_page": 15,
        "to": 2,
        "total": 2
    }
}

取得電話號碼

https://{API_DOMAIN}/api/v1/phone-number/{phone_number}

curl -X GET
    -H "Content-Type: application/json"
    https://{API_HOST}/api/v1/245621

URL Parameters

PARAMETER	REQUIRED	DEFAULT	TYPE	DESCRIPTION
phone_number	true	NULL	Number	<電話號碼的id

Response

請參考電話號碼的回應格式

PROPERTY	TYPE	DESCRIPTION
data	Object	電話號碼

{
    "data": {
        "id": 245621,
        "type": 0,
        "extension": null,
        "number": "0928846763",
        "description": null,
        "profile_id": 1935008,
        "phone_contact": {
            "id": 480,
            "contact_id": 1935038,
            "phone_number_id": 245621,
            "is_visible": true
        }
    }
}

新增電話號碼

POST https://{API_DOMAIN}/api/v1/phone-number

curl -X POST
    -H "Content-Type: application/json"
    '{"type": 0, "number": "23255780374507", "extension": "54 311", "description": "Up-sized mobile focusgroup"}'
    https://{API_HOST}/api/v1/phone-number

Form Data

PARAMETER	REQUIRED	DEFAULT	TYPE	DESCRIPTION
contact_id	true	NULL	Number	客戶的 id (可透過 搜尋客戶 取得客戶的 id)
type	true	NULL	Number	0: 住家, 1: 公司, 2: 手機, 3: 傳真, 4: 其他
number	true	NULL	String	電話號碼
extension	false	NULL	String	分機號碼
description	false	NULL	String	備註

回傳 json 格式

{
    "data": {
        "id": 1,
        "type": 0,
        "extension": "54 311",
        "number": "23255780374507",
        "description": "Up-sized mobile focusgroup",
        "profile_id": 1
    }
}

更新電話號碼

PUT https://{API_DOMAIN}/api/v1/phone-number/{phone_number}

curl -X PUT
    -H "Content-Type: application/json"
    '{"type": 2, "number": "0939888999", "extension": ""}'
    https://{API_HOST}/api/v1/phone-number/1

URL Parameters

PARAMETER	REQUIRED	DEFAULT	TYPE	DESCRIPTION
phone_number	true	NULL	Number	電話號碼的id

Form Data

PARAMETER	REQUIRED	DEFAULT	TYPE	DESCRIPTION
contact_id	true	NULL	Number	客戶的 id
type	false	NULL	Number	0: 住家, 1: 公司, 2: 手機, 3: 傳真, 4: 其他
number	false	NULL	String	電話號碼
extension	false	NULL	String	分機號碼
description	false	NULL	String	備註

Response

請參考電話號碼的回應格式

{
    "data": {
        "id": 1,
        "type": 2,
        "extension": "",
        "number": "0939888999",
        "description": "Up-sized mobile focusgroup",
        "profile_id": 1
    }
}

刪除電話號碼

Http status 為 204

DELETE https://{API_DOMAIN}/api/v1/phone-number/{phone_number}

curl -X DELETE
    -H "Content-Type: application/json"
    https://{API_HOST}/api/v1/phone-number/1

URL Parameters

PARAMETER	REQUIRED	DEFAULT	TYPE	DESCRIPTION
phone_number	true	NULL	Number	電話號碼的id

回傳 json 格式

{}