为什么LinkedIn API上共享返回400个坏请求？

Question

我试图通过LinkedIn API上的共享发布一个LinkedIn共享更新，使用PHP库LinkedIn-Client API。我已经成功地授权了该用户，并从该用户那里返回了访问令牌。我将该令牌与这个共享API调用一起使用。下面是我的代码：

$linkedInOAuth = new Happyr\LinkedIn\LinkedIn(LINKEDIN_APP_ID, LINKEDIN_APP_SECRET);

if ($accessToken) { // assume that it is retrieved from session
    $linkedInOAuth->setAccessToken($accessToken);

    $postParams = array(
        "content" => array(
            'description' => "I'm so exciting to share a post using API."
        ),
        "visibility" => array(
            "code" => "connnections-only"
        )
    );

    $result = $linkedInOAuth->api(
        "v1/people/~/shares",
        array("format" => "json"),
        "POST",
        $postParams
    );
}

LinkedIn-Client API在内部使用Guzzle处理HTTP请求。我试图直接使用guzzlehttp，而不使用happyr\linkedin\linkedin->api()，但是错误相同，没有成功。

if ($accessToken) {
    $url = 'https://api.linkedin.com/v1/people/~/shares?format=json&oauth2_access_token=' . $accessToken;

    $client = new GuzzleHttp\Client();

    $response = $client->post($url, array(
        'headers' => array(
            'Content-Type' => 'application/json',
            'x-li-format'  => 'json'
        ),
        'json' => array(
            'comment' => 'Check out developer.linkedin.com!',
            'content' => array(
                'description' => 'I\'m so exciting to share a post using API.'
            ),
            'visibility' => array(
                'code' => 'connections-only'
            )
        )
    ));
}

致命错误：未捕获的异常“GUZZLEHTTP\exception\ClientException”，带有消息“Client error response[url]https://api.linkedin.com/v1/people/~/shares？format=json&oauth2_access_token=xxxxx[status code]400[reason Phrace]Bad Request”在\vendor\guzzle\src\exception\requestException.php:89堆栈跟踪guzzleHTTP\guzzle\src\event\emitter.php(109):guzzleHTTP\subscriber\httperror->oncomplete(Object(GuzzleHTTP\event\completeEvent),'complete')#2\vendor\guzzleHTTP\guzzle\src\requestFSM.php(91):guzzleHTTP\event\completeEvent.php,'complete')

我复制并使用了LinkedIn API页面上共享的xml和json示例。这一次，错误更改为内部服务器错误。

if ($accessToken) {
    $format = 'xml';
    $url = 'https://api.linkedin.com/v1/people/~/shares?format='.$format.'&oauth2_access_token=' . $connect->accessToken;
    $postParams = array(
        "xml" => "
            <share>
                <comment>Check out developer.linkedin.com!</comment>
                <content>
                    <title>LinkedIn Developer Resources</title>
                    <description>Leverage LinkedIn's APIs to maximize engagement</description>
                    <submitted-url>https://developer.linkedin.com</submitted-url>
                    <submitted-image-url>https://example.com/logo.png</submitted-image-url>
                </content>
                <visibility>
                    <code>anyone</code>
                </visibility>
            </share>",
        "json" => array(
            "comment" => "Check out developer.linkedin.com!",
            "content" => array(
                "title" => "LinkedIn Developers Resources",
                "description" => "Leverage LinkedIn's APIs to maximize engagement",
                "submitted-url" => "https://developer.linkedin.com",
                "submitted-image-url" => "https://example.com/logo.png"
            ),
            "visibility" => array(
                "code" => "anyone"
            )
        )
    );

    $client = new GuzzleHttp\Client();

    if ($format === 'xml') {
        $response = $client->post($url, array(
            'body' => $postParams['xml']
        ));
    } else {
        $response = $client->post($url, array(
            'headers' => array(
                'Content-Type' => 'application/json',
                'x-li-format'  => 'json'
            ),
            'json' => $postParams['json']
        ));
    }
}

致命错误：未捕获的异常“GUZZLEHTTP\exception\ServerException”，消息为“服务器错误响应[url]https://api.linkedin.com/v1/people/~/shares？format=json&oauth2_access_token=xxxx[状态代码]500[原因短语]内部服务器错误”

Answer 1

根据happyr\linkedin-api-client的Github问题，在0.5.0中进行了一些更新，它解决了我的问题。然而，LinkedIn关于其Share API的文档并不清楚。必须注意以下信息：

• 注释字段是共享更新内容。名称comment会引起混乱。
• 使用字段注释，URL在共享更新内容中是可选的。
• content字段表示您共享的URL内容的快照。为了更清楚地描述，它反映了开放的图元标记；
  • content.title重写
  • content.description重写
  • content.title重写
  • content.submited-url重写
  • content.submited-image-url重写

  下面是使用happyr\linkedin-api-client的API的正确用法。

  $linkedInOAuth = new Happyr\LinkedIn\LinkedIn(LINKEDIN_APP_ID, LINKEDIN_APP_SECRET);
  // retrieve $accessToken from db or session
  $linkedInOAuth->setAccessToken($accessToken);
  
  $postParams = array(
      'json' => array(
          "comment" => "PHPLucidFrame - The simple, lightweight and flexible web application development framework http://phplucidframe.sithukyaw.com",
          "visibility" => array(
              "code" => "anyone"
          )
      )
  );
  
  $result = $linkedInOAuth->post('v1/people/~/shares', $postParams);
  

  $linkedInOAuth = new Happyr\LinkedIn\LinkedIn(LINKEDIN_APP_ID, LINKEDIN_APP_SECRET);
  // retrieve $accessToken from db or session
  $linkedInOAuth->setAccessToken($accessToken);
  
  $postParams = array(
      'json' => array(
          "content" => array(
              "title" => "PHPLucidFrame",
              "description" => "The simple, lightweight and flexible web application development framework",
              "submitted-url" => "http://phplucidframe.sithukyaw.com"
          ),
          "visibility" => array(
              "code" => "anyone"
          )
      )
  );
  
  $result = $linkedInOAuth->post('v1/people/~/shares', $postParams);
  

  下面是使用GuzzleHTTP的API的正确用法。

  // retrieve $accessToken from db or session
  $url = 'https://api.linkedin.com/v1/people/~/shares?format=json&oauth2_access_token=' . $accessToken;
  $client = new GuzzleHttp\Client();
  $response = $client->post($url, array(
      "json" => array(
          "comment" => "PHPLucidFrame - The simple, lightweight and flexible web application development framework http://phplucidframe.sithukyaw.com",
          "visibility" => array(
              "code" => "anyone"
          )
      )
  ));
  

  // retrieve $accessToken from db or session
  $url = 'https://api.linkedin.com/v1/people/~/shares?format=json&oauth2_access_token=' . $accessToken;
  $client = new GuzzleHttp\Client();
  $response = $client->post($url, array(
      "json" => array(
          "content" => array(
              "title" => "PHPLucidFrame",
              "description" => "The simple, lightweight and flexible web application development framework",
              "submitted-url" => "http://phplucidframe.sithukyaw.com"
          ),
          "visibility" => array(
              "code" => "anyone"
          )
      )
  ));
  

  字段comment和content也可以一起使用。