GET /v20.0/{app-id}/subscriptions 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(
'/{app-id}/subscriptions',
'{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 */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{app-id}/subscriptions",
null,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{app-id}/subscriptions"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
Name | Beschreibung | Typ |
---|---|---|
| Gibt den Objekttyp für dieses Abonnement an. |
|
| Die URL, welche die |
|
| Der Satz von Feldern in diesem |
|
| Gibt an, ob das Abonnement aktiv ist. |
|
Mit dieser Edge kannst du neue Webhooks-Abonnements erstellen:
POST /v20.0/{app-id}/subscriptions HTTP/1.1
Host: graph.facebook.com
object=page&callback_url=http%3A%2F%2Fexample.com%2Fcallback%2F&fields=about%2C+picture&include_values=true&verify_token=thisisaverifystring
/* PHP SDK v5.0.0 */
/* make the API call */
try {
// Returns a `Facebook\FacebookResponse` object
$response = $fb->post(
'/{app-id}/subscriptions',
array (
'object' => 'page',
'callback_url' => 'http://example.com/callback/',
'fields' => 'about, picture',
'include_values' => 'true',
'verify_token' => 'thisisaverifystring',
),
'{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 */
Bundle params = new Bundle();
params.putString("object", "page");
params.putString("callback_url", "http://example.com/callback/");
params.putString("fields", "about, picture");
params.putString("include_values", "true");
params.putString("verify_token", "thisisaverifystring");
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{app-id}/subscriptions",
params,
HttpMethod.POST,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
NSDictionary *params = @{
@"object": @"page",
@"callback_url": @"http://example.com/callback/",
@"fields": @"about, picture",
@"include_values": @"true",
@"verify_token": @"thisisaverifystring",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{app-id}/subscriptions"
parameters:params
HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
Bei einer POST-Anfrage mit diesen callback_url
-, verify_token
- und object
-Feldern wird das Abonnement reaktiviert.
user
sind nur für Nutzer*innen gültig, welche die App installiert haben.page
sind nur für Seiten gültig, welche die App installiert haben. Mit der /{page-id}/subscribed_apps-Edge kannst du die App für eine Seite installieren. Name | Beschreibung | Typ |
---|---|---|
| Gibt den Objekttyp für dieses Abonnement an. |
|
| Die URL, welche die |
|
| Mindestens eines aus der Auswahl gültiger Fehler in diesem |
|
| Gibt an, ob Änderungsbenachrichtigungen die neuen Werte enthalten sollen. |
|
| Ein beliebiger String, mit dem du deinem Server gegenüber bestätigen kannst, dass die Anfrage gültig ist. |
|
Wenn deine Rückruf-URL gültig ist und das Abonnement erfolgreich eingerichtet wurde:
{ "success": true }
Ansonsten wird eine entsprechende Fehlermeldung ausgegeben.
Mit diesem Vorgang kannst du alle Abonnements oder nur Abonnements für bestimmte Objekte löschen:
DELETE /v20.0/{app-id}/subscriptions HTTP/1.1
Host: graph.facebook.com
object=page
/* PHP SDK v5.0.0 */
/* make the API call */
try {
// Returns a `Facebook\FacebookResponse` object
$response = $fb->delete(
'/{app-id}/subscriptions',
array (
'object' => 'page',
),
'{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 */
Bundle params = new Bundle();
params.putString("object", "page");
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{app-id}/subscriptions",
params,
HttpMethod.DELETE,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
NSDictionary *params = @{
@"object": @"page",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{app-id}/subscriptions"
parameters:params
HTTPMethod:@"DELETE"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
Du kannst bestimmte Felder aus deinem Abonnement löschen, indem du einen fields
-Parameter einschließt.
Name | Beschreibung | Typ |
---|---|---|
| Ein bestimmter Objekttyp, für den Abonnements entfernt werden sollen. Wenn dieses optionale Feld nicht angegeben wird, werden alle Abonnements für diese App entfernt. |
|
| Mindestens eines aus der Auswahl gültiger Fehler in diesem |
|
Bei Erfolg:
{ "success": true }
Ansonsten wird eine entsprechende Fehlermeldung ausgegeben.
Du kannst Updates für diese Edge vornehmen, indem du einen Veröffentlichungsvorgang mit neuen Werten ausführst. Dadurch wird das Abonnement für das angegebene Thema geändert, ohne dass vorhandene Felder überschrieben werden.