php项目可以安装espocrm官方api客户端，使用独立api用户的密钥创建lead记录。客户端接收的是站点url，并会自动补充api/v1路径、认证头和请求处理；不要把站点地址再次拼成完整api前缀。开始前，先给api用户配置所需实体和操作权限。
EspoCRM官方PHP客户端安装和初始化示例
创建API用户并安装客户端
在EspoCRM的Administration > API Users中新建用户，选择API Key认证，并绑定允许创建及读取Lead的角色。密钥保存在服务端环境变量中。进入PHP项目目录执行：
composer require espocrm/php-espo-api-client
提交Lead并读取返回结果
下面的站点地址替换为自己的EspoCRM地址，ESPO_API_KEY由运行环境提供。字段仍须满足当前实例的必填项和自定义规则。
<?php
require __DIR__ . '/vendor/autoload.php';
use Espo\ApiClient\Client;
$key = getenv('ESPO_API_KEY');
if (!$key) {
throw new RuntimeException('请设置ESPO_API_KEY');
}
$client = new Client('https://crm.example.com');
$client->setApiKey($key);
$response = $client->request(Client::METHOD_POST, 'Lead', [
'firstName' => 'Test',
'lastName' => 'Hello',
]);
$result = $response->getParsedBody();
print_r($result);
根据响应处理失败
成功创建时返回新记录属性，可保存其中的id再读取同一记录核对。400通常与请求或必填字段有关，403应检查角色及操作权限，404检查实体和记录，409可能涉及重复或锁定。先读取具体响应，不在无法确认是否已创建时无条件重复POST。
EspoCRM官方API用户与API Key权限说明
