蓝虾仁工具站 - 邮编查询API开发文档

POST https://api.lanxiaren.com/api/tools/postcode

{
  "code": 200,
  "msg": "查询成功",
  "postcode": "518057",
  "address": "广东省深圳市南山区科技园街道",
  "adcode": "440305",
  "quota": {
    "used": 25,
    "remaining": 275,
    "total": 300
  }
}

{
  "code": 429,
  "msg": "今日免费额度已用尽，请购买套餐继续使用"
}

// 邮编查询函数
async function queryPostcode(province, city, district, street = '') {
  try {
    const requestData = new URLSearchParams({
      province: province,
      city: city,
      district: district,
      street: street
    });

    const response = await fetch('https://api.lanxiaren.com/api/tools/postcode', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/x-www-form-urlencoded'
      },
      body: requestData
    });

    const result = await response.json();
    if (result.code === 200) {
      console.log('查询成功：', result.postcode);
      return result;
    } else {
      console.error('查询失败：', result.msg);
      return result;
    }
  } catch (error) {
    console.error('网络异常：', error.message);
    return { code: 500, msg: '网络异常' };
  }
}

// 调用示例
queryPostcode('广东省', '深圳市', '南山区', '科技园街道');

<?php
// PHP调用邮编查询API示例
function callPostcodeAPI($province, $city, $district, $street = '', $apiKey = '') {
  $apiUrl = 'https://api.lanxiaren.com/api/tools/postcode';
  
  $params = [
    'province' => $province,
    'city' => $city,
    'district' => $district,
    'street' => $street
  ];
  
  if (!empty($apiKey)) {
    $params['api_key'] = $apiKey;
  }
  
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, $apiUrl);
  curl_setopt($ch, CURLOPT_POST, true);
  curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_TIMEOUT, 10);
  
  $response = curl_exec($ch);
  curl_close($ch);
  
  return json_decode($response, true);
}

// 调用示例
$result = callPostcodeAPI('广东省', '深圳市', '南山区');
if ($result['code'] === 200) {
  echo "邮编：" . $result['postcode'];
} else {
  echo "错误：" . $result['msg'];
}
?>