Graph API
Versão Graph API

Solicitar /{request-id}

Uma solicitação de jogo individual recebida por uma pessoa, enviada por um app ou por um usuário.

Guias relacionados

Leitura

Explorador da Graph API
GET /v21.0/{request-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{request-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{request-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{request-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{request-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permissões

  • Se você estiver fazendo a solicitação somente com o ID do objeto Solicitação e quiser saber o destinatário da solicitação, será necessário um token de acesso do usuário. A solicitação deve ter sido enviada à pessoa cujo token de acesso você está usando.
  • É possível usar um token de acesso do app ao fazer a solicitação com o ID do objeto Solicitação e a string de ID do usuário ou somente com o ID do objeto da solicitação sem saber as informações do destinatário. Para ver mais informações sobre o ID, consulte os documentos sobre solicitações.

Campos

Nome Descrição Tipo

id

O ID do objeto da solicitação.

string

application

O app associado à solicitação.

App

to

O destinatário da solicitação.

User

from

O remetente associado à solicitação. Esse campo é incluído somente em solicitações de usuário para usuário.

User

message

Uma string que descreve a solicitação.

string

created_time

O registro de data e hora de quando a solicitação foi criada.

datetime

Publicação

Não é possível publicar com esse ponto de extremidade.

As solicitações são publicadas por meio do diálogo Solicitação de jogo. Caso o seu app seja um jogo, será possível publicar solicitações de app por meio da borda /{user-id}/apprequests.

Exclusão

DELETE /v21.0/{request-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->delete(
    '/{request-id}',
    array (),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{request-id}",
    "DELETE",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{request-id}",
    null,
    HttpMethod.DELETE,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{request-id}"
                                      parameters:params
                                      HTTPMethod:@"DELETE"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permissões

  • Caso você esteja usando somente o ID do objeto Solicitação, será necessário um token de acesso do usuário. A solicitação também deve ter sido enviada à pessoa cujo token de acesso você está usando.
  • Um token de acesso do app pode ser usado com o ID do objeto solicitação concatenado e a string de ID do usuário.

Campos

Não é necessário excluir nenhum campo.

Resposta

Caso a operação seja bem-sucedida:

{
  "success": true
}

Caso contrário, uma mensagem de erro relevante será retornada.

Atualização

Você não pode fazer atualizações usando esse ponto de extremidade.