/*
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
* All rights reserved.
|
*
|
* This source code is licensed under the license found in the
|
* LICENSE file in the root directory of this source tree.
|
*/
|
|
#import <Foundation/Foundation.h>
|
|
#import <FBSDKCoreKit/FBSDKGraphRequestFlags.h>
|
#import <FBSDKCoreKit/FBSDKGraphRequestHTTPMethod.h>
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
@class FBSDKGraphRequestConnection;
|
@protocol FBSDKGraphRequestConnecting;
|
|
typedef void (^FBSDKGraphRequestCompletion)(id<FBSDKGraphRequestConnecting> _Nullable connection,
|
id _Nullable result,
|
NSError *_Nullable error);
|
|
typedef void (^FBSDKGraphRequestBlock)(FBSDKGraphRequestConnection *_Nullable connection,
|
id _Nullable result,
|
NSError *_Nullable error);
|
|
/// A protocol to describe anything that represents a graph request
|
NS_SWIFT_NAME(GraphRequestProtocol)
|
@protocol FBSDKGraphRequest
|
|
/**
|
The request parameters.
|
*/
|
@property (nonatomic, copy) NSDictionary<NSString *, id> *parameters;
|
|
/**
|
The access token string used by the request.
|
*/
|
@property (nullable, nonatomic, readonly, copy) NSString *tokenString;
|
|
/**
|
The Graph API endpoint to use for the request, for example "me".
|
*/
|
@property (nonatomic, readonly, copy) NSString *graphPath;
|
|
/**
|
The HTTPMethod to use for the request, for example "GET" or "POST".
|
*/
|
@property (nonatomic, readonly, copy) FBSDKHTTPMethod HTTPMethod;
|
|
/**
|
The Graph API version to use (e.g., "v2.0")
|
*/
|
@property (nonatomic, readonly, copy) NSString *version;
|
|
/**
|
The graph request flags to use
|
*/
|
@property (nonatomic, readonly, assign) FBSDKGraphRequestFlags flags;
|
|
/**
|
Convenience property to determine if graph error recover is disabled
|
*/
|
@property (nonatomic, getter = isGraphErrorRecoveryDisabled) BOOL graphErrorRecoveryDisabled;
|
|
/**
|
Convenience property to determine if the request has attachments
|
*/
|
@property (nonatomic, readonly) BOOL hasAttachments;
|
|
/**
|
Starts a connection to the Graph API.
|
@param completion The handler block to call when the request completes.
|
*/
|
- (id<FBSDKGraphRequestConnecting>)startWithCompletion:(nullable FBSDKGraphRequestCompletion)completion;
|
|
/**
|
A formatted description of the graph request
|
*/
|
- (NSString *)formattedDescription;
|
|
@end
|
|
NS_ASSUME_NONNULL_END
|
