Quizlet iOS
iOS 客户端，用于使用 Quizlet API 2.0。Quizlet API 允许对 Quizlet 的超过 16.4 亿张闪卡的内容数据库感兴趣的开发者与之交互。Quizlet API 允许您在自己的应用程序中创建、搜索和修改闪卡集和班级，以及更多功能。
我们还提供简单的 iOS 示例，其中包含对 Quizlet API 所有可能请求的全部代码。
安装
CocoaPods
pod 'Quizlet-iOS'
手动
Copy Quizlet folder from Sources to your project. List of needed files: Quizlet.h Quilzet.m QuizletConfig.h QuizletScope.h QuizletRequest.h QuizletRequest.m QuizletResponse.h QuizletAuth.h QuizletAuth.m QuizletClasses.h QuizletClasses.m QuizletImages.h QuizletImages.m QuizletSearch.h QuizletSearch.m QuizletSets.h QuizletSets.m QuizletUsers.h QuizletUsers.m
此框架需要 AFNetworking 2.0。您可以轻松使用其他库，AFNetworking 只在 QuizletRequest 类中使用。我认为这不会造成太大的问题，将会更改 http 请求的代码。
使用
为了设置客户端，您应该创建带您客户端 ID、密钥和重定向 URI 的实例。查看以下代码
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
[[Quizlet sharedQuizlet] startWithClientID:@"CLIENT_ID"
withSecretKey:@"SECRET_KEY"
withRedirectURI:@"yourappname:/after_oauth"];
return YES;
}
并在 openURL 方法中添加以下行
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
if ([[url scheme] isEqualToString:@"yourappname"]) {
[[Quizlet sharedQuizlet] handleURL:url];
}
return YES;
}
对于任何 Quizlet 请求，用户都应该进行授权。使用以下方法
[[Quizlet sharedQuizlet] authorize:^(void) {
NSLog(@"User was authorized");
} failure:^(NSError *error) {
NSLog(@"User wasn't authorized");
}];
现在您可以调用 Quizlet 请求了。
此库提供用于 Quizlet API 所有可能端点的函数（https://quizlet.com/api/2.0/docs/api_list）
/**
GET: /classes/CLASS_ID
View a single class.
*/
- (void)viewClassByClassId:(NSString *)classId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /classes/CLASS_ID/sets
View full details of all sets in a class.
*/
- (void)viewClassSetsByClassId:(NSString *)classId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
POST: /classes
Add a new class.
Required Parameters
Parameter Type Description
---------------------------------------
name string The name of the class
description string A description of what the class is about and who it's for.
school_id integer The id of the school to which this class belongs. Either this must be specified, or new_school_name, city, state, and country must be specified in the case of a new school
new_school_name string The name of the school to which this class belongs. Either this must be specified, or school_id must be specified if the school already exists
city string The city of the school to which this class belongs. Either this must be specified, or school_id must be specified if the school already exists
state string The 2 digit state code of the school to which this class belongs. This is only required for US schools
country string The country of the school to which this class belongs. Either this must be specified, or school_id must be specified if the school already exists
Optional Parameters
Parameter Type Description Default
---------------------------------------------------------------------------------------------------------------------------
allow_discussion boolean 0 or 1. Flag of whether users are allowed to use the discussion box on this class. 1
allow_member_add_sets boolean Deprecated
is_public boolean Deprecated
password boolean Deprecated
*/
- (void)addClassFromDictionary:(NSDictionary *)dictionary success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
PUT: /classes/CLASS_ID
Edit a class.
Required Parameters
---------------------
There are no specific required parameters - but if you do not send any parameters at all, the response will be 400-level error (as there is nothing to update).
Optional Parameters
Parameter Type Description
---------------------------------------------------
name string The name of the class.
description string Block of text describing the class.
allow_discussion boolean 0 or 1. Flag of whether users are allowed to use the discussion box on this class.
admin_only boolean 0 or 1. Flag of whether non-admin users are allowed to invite other members and add sets to this class.
allow_member_add_sets boolean Deprecated
is_public boolean Deprecated
password boolean Deprecated
*/
- (void)editClassWithDictionary:(NSDictionary *)dictionary byClassId:(NSString *)classId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
DELETE: /classes/CLASS_ID
Delete a class.
*/
- (void)deleteClassByClassId:(NSString *)classId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
PUT: /classes/CLASS_ID/sets/SET_ID
Add a set to a class.
*/
- (void)addSetBySetId:(NSString *)setId forClassId:(NSString *)classId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
DELETE: /classes/CLASS_ID/sets/SET_ID
Remove a set from a class.
*/
- (void)deleteSetBySetId:(NSString *)setId fromClassByClassId:(NSString *)classId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
PUT: /classes/CLASS_ID/members/USERNAME
Join (or apply to join) a class.
*/
- (void)joinClassByClassId:(NSString *)classId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
DELETE: /classes/CLASS_ID/members/USERNAME
Leave a class.
*/
- (void)leaveClassByClassId:(NSString *)classId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
POST: /images
Upload one or more images
Parameter Type Description
imageData[] array An array of one or more images.
*/
- (void)uploadImageFromURL:(NSURL *)url success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /search/sets
Search for sets by title, description or term. Returns limited information.
Optional Parameters
---------------------
While all of the parameters below are optional, at least one of q, term or creator must be provided.
Parameters specified are used as an "AND" operation, e.g. "q=spanish&term=silla" will return spanish sets that contain the term "silla."
0 or 1. When 1, returns results with partial matching for autocompleting.
Parameter Type Description Default
---------------------------------------------------------------------------------------------------------------------------------
q string Returns sets with titles and/or subjects that match your query. -
term string Return sets that have the specified term in them. -
creator string Returns sets created by the specified Quizlet user. -
images_only boolean 0 or 1. When 1, limits results to sets with images only. 0
autocomplete boolean 0
modified_since timestamp Limits results to sets that have been modified since the specified Unix timestamp. -
sort string Deprecated. The field to sort by. This will cause bad results and should never be used -
page integer The page of the result set to display. 1
per_page integer The number of sets to display per page (must be between 1 and 50). 30
*/
- (void)searchSetsWithParameters:(NSDictionary *)dictionary success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /search/definitions
Search for definitions.
Required Parameters
Parameter Type Description
-----------------------------------
q string The search query (case-insensitive).
Optional Parameters
Parameter Type Description Default
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
type string One of "all", "user", "official" "user".
limit integer Number of definitions to limit of each type. For example, if type is set to "all" and limit is set to 2, you will get 2 user and 2 official definitions (for a total of 4). 10
*/
- (void)searchDefinitionsWithParameters:(NSDictionary *)dictionary success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /search/classes
Search for classes by their title and description.
Required Parameters
Parameter Type Description
--------------------------------
q string The search query (case-insensitive).
Optional Parameters
Parameter Type Description Default
-----------------------------------------------------------------------------------------------------
page integer The page of the result set to display. 1
per_page integer The number of classes to display per page (must be between 1 and 50). 30
*/
- (void)searchGroupsWithParameters:(NSDictionary *)dictionary success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /search/universal
Search for classes, users, and sets all together
Required Parameters
Parameter Type Description
--------------------------------
q string The search query (case-insensitive).
Optional Parameters
Parameter Type Description Default
-----------------------------------------------------------------------------------------------------
page integer The page of the result set to display. 1
per_page integer The number of results to display per page (must be between 1 and 50). 30
*/
- (void)searchUniversalWithParameters:(NSDictionary *)dictionary success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /sets/SET_ID
View complete details (including all terms) of a single set.
*/
- (void)viewSetBySetId:(NSString *)setId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /sets/SET_ID/terms
View just the terms in a single set.
*/
- (void)viewSetTermsBySetId:(NSString *)setId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /sets/SET_ID/password
Submit a password for a password-protected set.
Required Parameters
Parameter Type Description
--------------------------------
password string The password for the set
*/
- (void)submitPassword:(NSString *)password forSetBySetId:(NSString *)setId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /sets
View complete details of multiple sets at once.
*/
- (void)viewSetsBySetIds:(NSString *)setIds success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
POST: /sets
Add a new set
Required Parameters
Parameter Type Description
-----------------------------------
title string The title of the set
terms[] array The text of a new term. Specify as many terms[] parameters as needed.
definitions[] array The text of a new definition. The number of definitions[] must match that of terms[].
lang_terms string Language of the terms. See the list of possible languages.
lang_definitions string Language of the definitions. See the list of possible languages.
Optional Parameters
Parameter Type Description Default
-----------------------------------------------------------------------------------------------------------------------------------------------------------
images[] array The identifier of the image for a term. If present, the number of images[] must match that of terms[]. -
Specify empty identifiers for terms that have no image. You get image identifiers when you upload images.
description string A text description of the set. -
subjects[] array Deprecated. An array which will be ignored. -
allow_discussion boolean 0 or 1. Flag of whether users are allowed to use the discussion box on this set 1
visibility "public", Define who is allowed to view/use this set. "public"
"only_me", If set to classes, the parameter classes becomes mandatory.
"classes", If set to password, the parameter password becomes mandatory.
"password"
editable "only_me", Define who is allowed to edit this set. "only_me"
"classes", If set to classes, the parameter classes becomes mandatory.
"password" If set to password, the parameter password becomes mandatory.
classes[] array Only required when visibility="classes" or editable="classes". -
An array of class IDs (integers) that this set is visible and/or editable for.
password string Only required when visibility="password" or editable="password". -
The password required to view and/or edit this set.
*/
- (void)addSetFromDictionary:(NSDictionary *)dictionary success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
PUT: /sets/SET_ID
Edit an existing set
Required Parameters
----------------------
There are no specific required parameters - but if you do not send any parameters at all, the response will be 400-level error (as there is nothing to update).
Optional Parameters
Parameter Type Description
--------------------------------------------------
title string The title of the set.
description string A text description of the set.
term_ids[] array The array of term ids. For new terms, use a zero value (e.g. "term_ids[]=0").
For already-existing terms, use the term id from the term you're editing (e.g. "term_ids[]=818192").
If you don't want to replace all the terms at once, then use editing terms instead.
terms[] array A replacement array of terms. If you don't want to replace all the terms at once, then use editing terms instead.
definitions[] array A replacement array of definitions.
If present, the length of this array must match the terms array.
If you don't want to replace all the definitions at once, then use editing terms instead.
images[] array A replacement array of image identifiers.
If present, the length of this array must match the terms array.
See the notes above for details about replacing images. If you don't want to replace all the images at once, then use editing terms instead.
subjects[] array Deprecated. An array which will be ignored.
allow_discussion boolean 0 or 1. Flag of whether users are allowed to use the discussion box on this set.
visibility "public", Define who is allowed to view/use this set.
"only_me", If set to classes, the parameter classes becomes mandatory.
"classes", If set to password, the parameter password becomes mandatory.
"password"
editable "only_me", Define who is allowed to edit this set.
"classes", If set to classes, the parameter classes becomes mandatory.
"password" If set to password, the parameter password becomes mandatory.
classes[] array Only required when visibility="classes" or editable="classes".
An array of class IDs (integers) that this set is visible and/or editable for.
password string Only required when visibility="password" or editable="password".
The password required to view and/or edit this set.
lang_terms string Language of the terms. See the list of possible languages.
lang_definitions string Language of the definitions. See the list of possible languages.
*/
- (void)editSetWithDictionary:(NSDictionary *)dictionary bySetId:(NSString *)setId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
DELETE: /sets/SET_ID
Delete an existing set
*/
- (void)deleteSetBySetId:(NSString *)setId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
POST: /sets/SET_ID/terms
Add a single term to a set
Required Parameters
Parameter Type Description
---------------------------------
term string The actual term (front side of card).
definition string The definition of the term.
image string The identifier of the image for the term. You get image identifiers when you upload images.
*/
- (void)addTermFromDictionary:(NSDictionary *)dictionary toSetBySetId:(NSString *)setId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
PUT: /sets/SET_ID/terms/TERM_ID
Edit a single term within a set
Required Parameters
Parameter Type Description
---------------------------------
term string The actual term (front side of card).
definition string The definition of the term.
image string The identifier of the image for the term. You get image identifiers when you upload images.
*/
- (void)editTermWithDictionary:(NSDictionary *)dictionary fromSetBySetId:(NSString *)setId byTermId:(NSString *)termId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
DELETE: /sets/SET_ID/terms/TERM_ID
Delete a single term within a set
*/
- (void)deleteTermFromSetBySetId:(NSString *)setId byTermId:(NSString *)termId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /users/USERNAME
View basic user information, including their sets, favorites, last 25 sessions, etc.
*/
- (void)userDetails:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /users/USERNAME/sets
View complete details about all the user's created sets.
*/
- (void)userSets:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /users/USERNAME/favorites
View complete details about all the user's favorited sets.
*/
- (void)userFavorites:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /users/USERNAME/classes
View complete details about all the classes that the user is a member of.
*/
- (void)userClasses:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
GET: /users/USERNAME/studied
View the last 100 recently studied sessions for a user.
*/
- (void)userStudied:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
PUT: /users/USERNAME/favorites/SET_ID
Mark a set as a favorite.
*/
- (void)markUserSetAsFavoriteBySetId:(NSString *)setId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
/**
DELETE: /users/USERNAME/favorites/SET_ID
Unmark a set as a favorite.
*/
- (void)unmarkUserSetAsFavoriteBySetId:(NSString *)setId success:(void (^)(id responseObject))success failure:(void (^)(NSError *error))failure;
任何反馈、评论，我都可以听取。请自在分享。祝您编码愉快！
许可证
iOS Quizlet 客户端采用 MIT 许可协议。更多信息请参阅 LICENSE 文件。