2026-03-23 06:14:31 +08:00

103 lines
2.6 KiB
JavaScript

import { http } from '../../utils/request';
// ==================== 行政区域服务 ====================
/**
* 获取所有省份 (带缓存)
* @returns {Promise<Array<{
* id: number,
* code: string,
* name: string,
* parentCode: string
* }>>}
*/
export const regionProvincesGet = () => {
return http.get('/region/provinces');
};
/**
* 根据省份代码获取城市列表 (带缓存)
* @param {Object} params - 查询参数
* @param {string} params.provincecode - 省份代码
* @returns {Promise<Array<{
* id: number,
* code: string,
* name: string,
* parentCode: string
* }>>}
*/
export const regionCitiesbyprovinceGet = (params) => {
return http.get('/region/citiesbyprovince', { params });
};
/**
* 根据城市代码获取区县列表 (带缓存)
* @param {Object} params - 查询参数
* @param {string} params.citycode - 城市代码
* @returns {Promise<Array<{
* id: number,
* code: string,
* name: string,
* parentCode: string
* }>>}
*/
export const regionDistrictsbycityGet = (params) => {
return http.get('/region/districtsbycity', { params });
};
/**
* 分页查询省份信息
* @param {Object} data - 查询参数
* @param {number} [data.pageNo] - 当前页码
* @param {number} [data.pageSize] - 每页条数
* @param {string} [data.name] - 省份名称 (模糊查询)
* @param {string} [data.code] - 省份代码
* @returns {Promise<{
* pageNo: number,
* pageSize: number,
* pages: number,
* total: number,
* rows: Array<{
* id: number,
* code: string,
* name: string,
* parentCode: string
* }>
* }>}
*/
export const regionPageProvincesPost = (data) => {
return http.post('/region/page/provinces', data);
};
/**
* 添加省份
* @param {Object} data - 省份信息
* @param {number} [data.id] - 省份ID (编辑时传)
* @param {string} data.code - 省份代码
* @param {string} data.name - 省份名称
* @param {string} [data.parentCode] - 父级代码 (省份的父级代码通常为空)
*/
export const regionProvincePost = (data) => {
return http.post('/region/province', data);
};
/**
* 更新省份
* @param {Object} data - 省份信息
* @param {number} data.id - 省份ID
* @param {string} data.code - 省份代码
* @param {string} data.name - 省份名称
* @param {string} [data.parentCode] - 父级代码
*/
export const regionProvincePut = (data) => {
return http.put('/region/province', data);
};
/**
* 删除省份
* @param {Object} params - 删除参数
* @param {number} params.id - 省份ID
*/
export const regionProvinceDelete = (params) => {
return http.delete('/region/province', { params });
};