Facebook API v2.2 неправильный формат ответа конечной точки?

Question

Официальный Facebook Docs говорит следующее за v2.2 API:

Все оконечные API теперь всегда будет возвращать действительный JSON

Но когда я называю эту конечную точку:

https://graph.facebook.com/v2.2/oauth/access_token

Он возвращает плоскую строку вместо JSON в случае успеха :

HTTP/1.1 200 OK 
... 
access_token=XXX&expires=5182351 

Но та же конечная точка возвращает JSON, если не удалось:

HTTP/1.1 400 Bad Request 
... 
{"error":{"message":"This authorization code has expired.","type":"OAuthException","code":100}} 

Является ли это ошибка в API или ошибка в Документах?

Answer 1

Звучит скорее как надзор в семантике, чем что-либо.

oauth/access_token является точкой входа для API, тогда как большинство других точек, которые имеют graph.facebook.com в качестве базы, потребляют доступный токен, полученный оттуда.

т.е. graph.facebook.com/{object}?access_token=ACCESS_TOKEN

Подача documenation ошибка будет лучший способ узнать наверняка.