歡迎來到我們的API接口 專業資料平台，今天我們将介紹如何使用庫和架構API來簡化開發流程，建構快速、可靠的應用程式。在本文檔中，我們将重點介紹企業四要素API接口的作用，并提供一些示例代碼可以幫助您更好地了解。
企業四要素是在企業資訊檢驗中的重要組成部分。它包括企業名稱、法人名稱、社會統一信用代碼及法人身份證号，驗證四要素是否一緻，企業資訊是否真實、完整；每個要素都有其獨特的作用和意義，讓我們一起來看。
API接口四要素：
- company_name (string)：企業名稱。
- legal_representative (string)：法人名稱。
- credit_code (string)：社會統一信用代碼。
- id_card_number (string)：法人身份證号碼。
子接口：
- 企業工商四要素驗證
接口位址：https://www.wapi.cn/api_detail/184/358.html
傳回格式：json,xml,jsonp調用
請求方式：GET,POST
POST 請求需要設定Header頭：Content-Type: application/x-www-form-urlencoded;charset=utf-8
請求說明：
| 名稱 | 必填 | 類型 | 說明 | 示例參數另存 |
| appid | 是 | String | 應用ID，在背景我的應用檢視或者添加 | 1 |
| company_name | 是 | String | 企業名稱 | 北京小桔科技有限公司 |
| credit_code | 是 | String | 統一信用代碼 | 91350206MA32JUL977 |
| format | 否 | String | 傳回資料格式類型，每個接口已經說明支援傳回格式:json,xml, jsonp調用方法說明 | json |
| id_card | 是 | String | 法人身份證 | 362532199006024117 |
| legal_person | 是 | String | 企業法人姓名 | 張三 |
| sign | 是 | String | 1.使用Md5方式驗證，參數按一定規則md5後傳回的字元串，詳情點選這裡閱讀 2.使用Hash驗證方式，直接跟上密鑰即可。如何設定hash驗證 通過我的應用裡面修改驗證方式 | 52a9dbe274a5c537bbf7a53e2d66c09f |
| time | 否 | String | 請求時傳遞的目前伺服器時間戳 | 1545829466 |
傳回參數說明：
| 名稱 | 必填 | 類型 | 說明 | 示例參數另存 |
| codeid | 否 | Integer | 狀态碼，傳回10000狀态都會進行計費。具體說明可檢視狀态碼說明 | 10000 |
| company_name | 是 | String | 企業名稱 | 北京小桔科技有限公司 |
| credit_code | 是 | String | 統一信用代碼 | 91350206MA32JUL977 |
| id_card | 是 | String | 法人身份證 | 362532198004094117 |
| legal_person | 是 | String | 企業法人姓名 | 張三 |
| message | 否 | String | 請求狀态說明 | 查詢成功 |
| msg | 否 | String | 傳回狀态描述 | 一緻 |
| qy_status | 否 | String | 傳回的狀态碼，詳情點選這裡檢視 | 01 |
| retdata | 否 | Array | 回資料集合,可能是資料、對象或者字元串 | |
| time | 否 | String | 請求時傳遞的目前伺服器時間戳 | 1670404015 |
狀态碼說明：
| 狀态碼 | 說明 |
| 10000 | 傳回成功 |
| 10001 | appid必須指定，可以我的應用裡面檢視 |
| 10002 | sign值必須指定，加密規則請前往幫助中心檢視 |
| 10003 | sign值驗證不通過，加密規則請前往幫助中心檢視 |
| 10004 | 時差不能超過10分鐘，可以不傳遞這個參數，注意時間戳機關是秒 |
| 10005 | appid錯誤，請檢查appid值,前往會員中心->我的應用檢視或添加 |
| 10006 | 目前IP位址未授權，請前往使用者中心->我的應用添加ip{@info} |
| 10007 | 應用被禁用，請聯系客服處理 |
| 10008 | 應用内沒有該接口，請到我的應用裡面添加這個接口 |
| 10009 | api接口不存在 |
| 10010 | 您沒有添加該api接口 |
| 10011 | api已經到期 |
| 10012 | 沒有訂購任何api,請前往購買後再操作 |
| 10013 | 該接口已經暫停使用 |
| 10014 | 未知的錯誤，可以聯系客服處理 |
| 10015 | 參數個數錯誤 |
| 10019 | {@info} |
| 10017 | time必須是整型 |
| 10018 | 次數不足 |
| 10020 | 子接口不存在,可能已經被關閉 |
| 10021 | 伺服器發生錯誤 |
| 10022 | 帳戶餘額不足，請充值！ |
| 10023 | 訂單送出成功，等待回調結果 |
| 10024 | 調試模式資料 |
| 10025 | 查無資料 |
請求示例：
- PHP
- Python
$method = 'GET'; //請求方式 GET,POST
$secretType = 'MD5'; //驗證方式MD5,Hash 通過背景 我的應用去修改
$api_url = 'https://登入後顯示/pyi/184/358';
$appid = '應用id';// 在背景我的應用檢視;
$secret = '應用密鑰';// 在背景我的應用檢視;
$data = array(
'appid'=> '1',
'company_name'=> '北京小桔科技有限公司',
'credit_code'=> '91350206MA32JUL977',
'format'=> 'json',
'id_card'=> '362532199006024117',
'legal_person'=> '張三',
'time'=> '1545829466',
);
$data['appid'] = $appid;
$data['time'] = time();//目前伺服器時間
if('MD5' == $secretType){
ksort($data); //按照鍵名對數組排序，為數組值保留原來的鍵。
$md5String = '';
foreach($data as $key=>$val){
if(strlen($val)>0){ //過濾空值
$md5String.=$key.$val;
}
}
$secret = md5($md5String.$secret);
}
$data['sign'] = $secret;
if('GET'==$method){
$sendUrl = $api_url.'?'.http_build_query($data); //把資料轉換成url參數形式，a=b&c=d&e=f
$result = file_get_contents($sendUrl);
}else{
$header = ['Content-Type: application/x-www-form-urlencoded;charset=utf-8'];
$ch = curl_init();
if(is_array($data))$data = http_build_query($data);
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_POST, true);//POST
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_AUTOREFERER, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_ENCODING,'gzip,deflate');
$result = curl_exec($ch);
}
$result = json_decode($result,true);
print_r($result);
- 請使用HTTPS協定發送請求，確定資料傳輸的安全性。
- 請在請求頭中添加合适的身份認證資訊，如API密匙或指令牌。
- 請確定輸入的企業四要資訊準确無誤。
- 響應結果中的"valid"字段表示四要元素驗證結果，可以根據該字段判斷判斷是否通過。
通過使用企業四要核查核驗接口，您可以友善地驗證企業資訊的真實性和完整性，幫助您做出準确的判斷斷定和決策。請參考上述接口文檔進行接口調用和內建。