List of Error Codes for Facebook's API

facebook 曾经公布过这个列表, 但是后来删掉了. 千辛万苦找到了别人分享的东东, 存档备忘.

 

注: 最新的错误可能会没有

 

Overview

If you pass in a malformed or invalid API request, an error result gets returned. This is detectable by checking if the root element is of type error_response. Within this element, an error code and explanatory message are returned, as well as all of the parameter names and values of the original request.

In the example below, we see the error returned when an otherwise-valid request is made from an unauthorized IP address

Example Return XML

1 <? xml version="1.0" encoding="UTF-8" ?>
2   < error_response xmlns ="http://api.facebook.com/1.0/" xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation ="http://api.facebook.com/1.0/ http://api.facebook.com/1.0/facebook.xsd" >
3 < error_code > 5 </ error_code >
4 < error_msg > Unauthorized source IP address (ip was: 10.1.2.3) </ error_msg >
5 < request_args list ="true" >
6 < arg >
7 < key > method </ key >
8 < value > facebook.friends.get </ value >
9 </ arg >
10 < arg >
11 < key > session_key </ key >
12 < value > 373443c857fcda2e410e349c-i7nF4PqX4IW4. </ value >
13 </ arg >
14 < arg >
15 < key > api_key </ key >
16 < value > 0289b21f46b2ee642d5c42145df5489f </ value >
17 </ arg >
18 < arg >
19 < key > call_id </ key >
20 < value > 1170813376.3544 </ value >
21 </ arg >
22 < arg >
23 < key > v </ key >
24 < value > 1.0 </ value >
25 </ arg >
26 < arg >
27 < key > sig </ key >
28 < value > 570dcc2b764578af350ea1e1622349a0 </ value >
29 </ arg >
30 </ request_args >
31   </ error_response >

 

Error Code Table

General Errors

Errornumber	PHP Constant name	Error description	Generated by methods
0	API_EC_SUCCESS	Success	(all)
1	API_EC_UNKNOWN	An unknown error occurred	(all)
2	API_EC_SERVICE	Service temporarily unavailable	(all)
3	API_EC_METHOD	Unknown method
4	API_EC_TOO_MANY_CALLS	Application request limit reached	(all)
5	API_EC_BAD_IP	Unauthorized source IP address	(all)
6	API_EC_HOST_API	This method must run on api.facebook.com	(all)
7	API_EC_HOST_UP	This method must run on api-video.facebook.com
8	API_EC_SECURE	This method requires an HTTPS connection
9	API_EC_RATE	User is performing too many actions
10	API_EC_PERMISSION_DENIED	Application does not have permission for this action
11	API_EC_DEPRECATED	This method is deprecated
12	API_EC_VERSION	This API version is deprecated
13	API_EC_INTERNAL_FQL_ERROR	The underlying FQL query made by this API call has encountered an error. Please check that your parameters are correct.
14	API_EC_HOST_PUP	This method must run on api-photo.facebook.com
15	API_EC_SESSION_SECRET_NOT_ALLOWED	This method call must be signed with the application secret (You are probably calling a secure method using a session secret)
16	API_EC_HOST_READONLY	This method cannot be run on this host, which only supports read-only calls
17	API_EC_USER_TOO_MANY_CALLS	User request limit reached
18	API_EC_REQUEST_RESOURCES_EXCEEDED	This API call could not be completed due to resource limits

Parameter Errors

Errornumber	PHP Constant name	Error description	Generated by methods
100	API_EC_PARAM	Invalid parameter	(all)
101	API_EC_PARAM_API_KEY	Invalid API key	(all)
102	API_EC_PARAM_SESSION_KEY	Session key invalid or no longer valid	(all)
103	API_EC_PARAM_CALL_ID	Call_id must be greater than previous
104	API_EC_PARAM_SIGNATURE	Incorrect signature	(all)
105	API_EC_PARAM_TOO_MANY	The number of parameters exceeded the maximum for this operation
110	API_EC_PARAM_USER_ID	Invalid user id	photos.addTag
111	API_EC_PARAM_USER_FIELD	Invalid user info field
112	API_EC_PARAM_SOCIAL_FIELD	Invalid user field
113	API_EC_PARAM_EMAIL	Invalid email
114	API_EC_PARAM_USER_ID_LIST	Invalid user ID list
115	API_EC_PARAM_FIELD_LIST	Invalid field list
120	API_EC_PARAM_ALBUM_ID	Invalid album id
121	API_EC_PARAM_PHOTO_ID	Invalid photo id
130	API_EC_PARAM_FEED_PRIORITY	Invalid feed publication priority
140	API_EC_PARAM_CATEGORY	Invalid category
141	API_EC_PARAM_SUBCATEGORY	Invalid subcategory
142	API_EC_PARAM_TITLE	Invalid title
143	API_EC_PARAM_DESCRIPTION	Invalid description
144	API_EC_PARAM_BAD_JSON	Malformed JSON string
150	API_EC_PARAM_BAD_EID	Invalid eid
151	API_EC_PARAM_UNKNOWN_CITY	Unknown city
152	API_EC_PARAM_BAD_PAGE_TYPE	Invalid page type
170	API_EC_PARAM_BAD_LOCALE	Invalid locale
180	API_EC_PARAM_BLOCKED_NOTIFICATION	This notification was not delieved
190	API_EC_PARAM_ACCESS_TOKEN	Invalid OAuth 2.0 Access Token

User Permission Errors

Errornumber	PHP Constant name	Error description	Generated by methods
200	API_EC_PERMISSION	Permissions error
210	API_EC_PERMISSION_USER	User not visible
211	API_EC_PERMISSION_NO_DEVELOPERS	Application has no developers.	admin.setAppProperties
212	API_EC_PERMISSION_OFFLINE_ACCESS	Renewing a session offline requires the extended permission offline_access
220	API_EC_PERMISSION_ALBUM	Album or albums not visible
221	API_EC_PERMISSION_PHOTO	Photo not visible
230	API_EC_PERMISSION_MESSAGE	Permissions disallow message to user
240	API_EC_PERMISSION_MARKUP_OTHER_USER	Desktop applications cannot set FBML for other users
250	API_EC_PERMISSION_STATUS_UPDATE	Updating status requires the extended permission status_update.	users.setStatus
260	API_EC_PERMISSION_PHOTO_UPLOAD	Modifying existing photos requires the extended permission photo_upload	photos.upload,photos.addTag
261	API_EC_PERMISSION_VIDEO_UPLOAD	Modifying existing photos requires the extended permission photo_upload	photos.upload,photos.addTag
270	API_EC_PERMISSION_SMS	Permissions disallow sms to user.
280	API_EC_PERMISSION_CREATE_LISTING	Creating and modifying listings requires the extended permission create_listing
281	API_EC_PERMISSION_CREATE_NOTE	Managing notes requires the extended permission create_note.
282	API_EC_PERMISSION_SHARE_ITEM	Managing shared items requires the extended permission share_item.
290	API_EC_PERMISSION_EVENT	Creating and modifying events requires the extended permission create_event	events.create, events.edit
291	API_EC_PERMISSION_LARGE_FBML_TEMPLATE	FBML Template isn\'t owned by your application.
292	API_EC_PERMISSION_LIVEMESSAGE	An application is only allowed to send LiveMessages to users who have accepted the TOS for that application.	liveMessage.send
293	API_EC_PERMISSION_XMPP_LOGIN	Logging in to chat requires the extended permission xmpp_login	Integrating with FacebookChat
294	API_EC_PERMISSION_ADS_MANAGEMENT	Managing advertisements requires the extended permission ads_management, and a participating API key	Ads API
296	API_EC_PERMISSION_CREATE_EVENT	Managing events requires the extended permission create_event	API#Events_API_Methods
298	API_EC_PERMISSION_READ_MAILBOX	Reading mailbox messages requires the extended permission read_mailbox	message.getThreadsInFolder
299	API_EC_PERMISSION_RSVP_EVENT	RSVPing to events requires the extended permission create_rsvp	events.rsvp

Data Editing Errors

Errornumber	PHP Constant name	Error description	Generated by methods
300	API_EC_EDIT	Edit failure
310	API_EC_EDIT_USER_DATA	User data edit failure
320	API_EC_EDIT_PHOTO	Photo edit failure
321	API_EC_EDIT_ALBUM_SIZE	Album is full
322	API_EC_EDIT_PHOTO_TAG_SUBJECT	Invalid photo tag subject
323	API_EC_EDIT_PHOTO_TAG_PHOTO	Cannot tag photo already visible on Facebook
324	API_EC_EDIT_PHOTO_FILE	Missing or invalid image file
325	API_EC_EDIT_PHOTO_PENDING_LIMIT	Too many unapproved photos pending
326	API_EC_EDIT_PHOTO_TAG_LIMIT	Too many photo tags pending
327	API_EC_EDIT_ALBUM_REORDER_PHOTO_NOT_IN_ALBUM	Input array contains a photo not in the album
328	API_EC_EDIT_ALBUM_REORDER_TOO_FEW_PHOTOS	Input array has too few photos
329	API_EC_MALFORMED_MARKUP	Template data must be a JSON-encoded dictionary, of the form {\'key-1\': \'value-1\', \'key-2\': \'value-2\', ...}
330	API_EC_EDIT_MARKUP	Failed to set markup
340	API_EC_EDIT_FEED_TOO_MANY_USER_CALLS	Feed publication request limit reached
341	API_EC_EDIT_FEED_TOO_MANY_USER_ACTION_CALLS	Feed action request limit reached
342	API_EC_EDIT_FEED_TITLE_LINK	Feed story title can have at most one href anchor
343	API_EC_EDIT_FEED_TITLE_LENGTH	Feed story title is too long
344	API_EC_EDIT_FEED_TITLE_NAME	Feed story title can have at most one fb:userlink and must be of the user whose action is being reported
345	API_EC_EDIT_FEED_TITLE_BLANK	Feed story title rendered as blank
346	API_EC_EDIT_FEED_BODY_LENGTH	Feed story body is too long
347	API_EC_EDIT_FEED_PHOTO_SRC	Feed story photo could not be accessed or proxied
348	API_EC_EDIT_FEED_PHOTO_LINK	Feed story photo link invalid
350	API_EC_EDIT_VIDEO_SIZE	Video file is too large	video.upload
351	API_EC_EDIT_VIDEO_INVALID_FILE	Video file was corrupt or invalid	video.upload
352	API_EC_EDIT_VIDEO_INVALID_TYPE	Video file format is not supported	video.upload
353	API_EC_EDIT_VIDEO_FILE	Missing video file	video.upload
354	API_EC_EDIT_VIDEO_NOT_TAGGED	User is not tagged in this video
355	API_EC_EDIT_VIDEO_ALREADY_TAGGED	User is already tagged in this video
360	API_EC_EDIT_FEED_TITLE_ARRAY	Feed story title_data argument was not a valid JSON-encoded array
361	API_EC_EDIT_FEED_TITLE_PARAMS	Feed story title template either missing required parameters, or did not have all parameters defined in title_data array
362	API_EC_EDIT_FEED_BODY_ARRAY	Feed story body_data argument was not a valid JSON-encoded array
363	API_EC_EDIT_FEED_BODY_PARAMS	Feed story body template either missing required parameters, or did not have all parameters defined in body_data array
364	API_EC_EDIT_FEED_PHOTO	Feed story photos could not be retrieved, or bad image links were provided
365	API_EC_EDIT_FEED_TEMPLATE	The template for this story does not match any templates registered for this application
366	API_EC_EDIT_FEED_TARGET	One or more of the target ids for this story are invalid. They must all be ids of friends of the acting user
367	API_EC_EDIT_FEED_MARKUP	The template data provided doesn't cover the entire token set needed to publish the story
370	API_EC_USERS_CREATE_INVALID_EMAIL	The email address you provided is not a valid email address
371	API_EC_USERS_CREATE_EXISTING_EMAIL	The email address you provided belongs to an existing account
372	API_EC_USERS_CREATE_BIRTHDAY	The birthday provided is not valid
373	API_EC_USERS_CREATE_PASSWORD	The password provided is too short or weak
374	API_EC_USERS_REGISTER_INVALID_CREDENTIAL	The login credential you provided is invalid.
375	API_EC_USERS_REGISTER_CONF_FAILURE	Failed to send confirmation message to the specified login credential.
376	API_EC_USERS_REGISTER_EXISTING	The login credential you provided belongs to an existing account
377	API_EC_USERS_REGISTER_DEFAULT_ERROR	Sorry, we were unable to process your registration.
378	API_EC_USERS_REGISTER_PASSWORD_BLANK	Your password cannot be blank. Please try another.
379	API_EC_USERS_REGISTER_PASSWORD_INVALID_CHARS	Your password contains invalid characters. Please try another.
380	API_EC_USERS_REGISTER_PASSWORD_SHORT	Your password must be at least 6 characters long. Please try another.
381	API_EC_USERS_REGISTER_PASSWORD_WEAK	Your password should be more secure. Please try another.
382	API_EC_USERS_REGISTER_USERNAME_ERROR	Our automated system will not approve this name.
383	API_EC_USERS_REGISTER_MISSING_INPUT	You must fill in all of the fields.
384	API_EC_USERS_REGISTER_INCOMPLETE_BDAY	You must indicate your full birthday to register.
385	API_EC_USERS_REGISTER_INVALID_EMAIL	Please enter a valid email address.
386	API_EC_USERS_REGISTER_EMAIL_DISABLED	The email address you entered has been disabled. Please contact disabled@facebook.com with any questions.
387	API_EC_USERS_REGISTER_ADD_USER_FAILED	There was an error with your registration. Please try registering again.
388	API_EC_USERS_REGISTER_NO_GENDER	Please select either Male or Female.

Authentication Errors

Error number	PHP Constant name	Error description	Generated by methods
400	API_EC_AUTH_EMAIL	Invalid email address
401	API_EC_AUTH_LOGIN	Invalid username or password
402	API_EC_AUTH_SIG	Invalid application auth sig
403	API_EC_AUTH_TIME	Invalid timestamp for authentication

Session Errors

Errornumber	PHP Constant name	Error description	Generated by methods
450	API_EC_SESSION_TIMED_OUT	Session key specified has passed its expiration time
451	API_EC_SESSION_METHOD	Session key specified cannot be used to call this method
452	API_EC_SESSION_INVALID	Session key invalid. This could be because the session key has an incorrect format, or because the user has revoked this session
453	API_EC_SESSION_REQUIRED	A session key is required for calling this method
454	API_EC_SESSION_REQUIRED_FOR_SECRET	A session key must be specified when request is signed with a session secret
455	API_EC_SESSION_CANNOT_USE_SESSION_SECRET	A session secret is not permitted to be used with this type of session key

Application Messaging Errors

Error number	PHP Constant name	Error description	Generated by methods
500	API_EC_MESG_BANNED	Message contains banned content
501	API_EC_MESG_NO_BODY	Missing message body
502	API_EC_MESG_TOO_LONG	Message is too long
503	API_EC_MESG_RATE	User has sent too many messages
504	API_EC_MESG_INVALID_THREAD	Invalid reply thread id
505	API_EC_MESG_INVALID_RECIP	Invalid message recipient
510	API_EC_POKE_INVALID_RECIP	Invalid poke recipient
511	API_EC_POKE_OUTSTANDING	There is a poke already outstanding
512	API_EC_POKE_RATE	User is poking too fast
513	API_EC_POKE_USER_BLOCKED	User cannot poke via API

FQL Errors

Errornumber	PHP Constant name	Error description	Generated by methods
600	FQL_EC_UNKNOWN_ERROR	An unknown error occurred in FQL	fql.query,fql.multiquery
601	FQL_EC_PARSER_ERROR	Error while parsing FQL statement	fql.query,fql.multiquery
602	FQL_EC_UNKNOWN_FIELD	The field you requested does not exist	fql.query,fql.multiquery
603	FQL_EC_UNKNOWN_TABLE	The table you requested does not exist	fql.query,fql.multiquery
604	FQL_EC_NO_INDEX	Your statement is not indexable	fql.query,fql.multiquery
605	FQL_EC_UNKNOWN_FUNCTION	The function you called does not exist	fql.query,fql.multiquery
606	FQL_EC_INVALID_PARAM	Wrong number of arguments passed into the function	fql.query,fql.multiquery
607	FQL_EC_INVALID_FIELD	FQL field specified is invalid in this context.	fql.query*,fql.multiquery
608	FQL_EC_INVALID_SESSION	An invalid session was specified	fql.query,fql.multiquery
609	FQL_EC_UNSUPPORTED_APP_TYPE	FQL field specified is invalid in this context.	fql.query*,fql.multiquery
610	FQL_EC_SESSION_SECRET_NOT_ALLOWED	FQL field specified is invalid in this context.	fql.query*,fql.multiquery
611	FQL_EC_DEPRECATED_TABLE	FQL field specified is invalid in this context.	fql.query*,fql.multiquery
612	FQL_EC_EXTENDED_PERMISSION	The stream requires an extended permission	fql.query,fql.multiquery
613	FQL_EC_RATE_LIMIT_EXCEEDED	Calls to stream have exceeded the rate of 100 calls per 600 seconds.	fql.query,fql.multiquery
614	FQL_EC_UNRESOLVED_DEPENDENCY	Unresolved dependency in multiquery	fql.multiquery
615	FQL_EC_INVALID_SEARCH	This search is invalid	fql.query,fql.multiquery
617	FQL_EC_TOO_MANY_FRIENDS_FOR_PRELOAD	The user you queried against has too many friends to be used with Preload FQL, in order to avoid out of memory errors	fql.query,fql.multiquery

* This error is returned when the field name is sometimes valid, but not all the time. For example, if you run fql.query on the Metrics FQL table, you can get this error because some metrics are queryable only over the daily period, as opposed to the weekly or monthly periods.

Ref Errors

Error number	PHP Constant name	Error description	Generated by methods
700	API_EC_REF_SET_FAILED	Unknown failure in storing ref data. Please try again.

Application Integration Errors

Errornumber	PHP Constant name	Error description	Generated by methods
750	API_EC_FB_APP_UNKNOWN_ERROR	Unknown Facebook application integration failure.
751	API_EC_FB_APP_FETCH_FAILED	Fetch from remote site failed.
752	API_EC_FB_APP_NO_DATA	Application returned no data. This may be expected or represent a connectivity error.
753	API_EC_FB_APP_NO_PERMISSIONS	Application returned user had invalid permissions to complete the operation.
754	API_EC_FB_APP_TAG_MISSING	Application returned data, but no matching tag found. This may be expected.
755	API_EC_FB_APP_DB_FAILURE	The database for this object failed.

Data Store API Errors

Errornumber	PHP Constant name	Error description	Generated by methods
800	API_EC_DATA_UNKNOWN_ERROR	Unknown data store API error
801	API_EC_DATA_INVALID_OPERATION	Invalid operation
802	API_EC_DATA_QUOTA_EXCEEDED	Data store allowable quota was exceeded
803	API_EC_DATA_OBJECT_NOT_FOUND	Specified object cannot be found
804	API_EC_DATA_OBJECT_ALREADY_EXISTS	Specified object already exists
805	API_EC_DATA_DATABASE_ERROR	A database error occurred. Please try again
806	API_EC_DATA_CREATE_TEMPLATE_ERROR	Unable to add FBML template to template database. Please try again.
807	API_EC_DATA_TEMPLATE_EXISTS_ERROR	No active template bundle with that ID or handle exists.
808	API_EC_DATA_TEMPLATE_HANDLE_TOO_LONG	Template bundle handles must contain less than or equal to 32 characters.
809	API_EC_DATA_TEMPLATE_HANDLE_ALREADY_IN_USE	Template bundle handle already identifies a previously registered template bundle, and handles can not be reused.
810	API_EC_DATA_TOO_MANY_TEMPLATE_BUNDLES	Application has too many active template bundles, and some must be deactivated before new ones can be registered.
811	API_EC_DATA_MALFORMED_ACTION_LINK	One of more of the supplied action links was improperly formatted.
812	API_EC_DATA_TEMPLATE_USES_RESERVED_TOKEN	One …or more of your templates is using a token reserved by Facebook, such as {*mp3*} or {*video*}.

Mobile/SMS Errors

Error number	PHP Constant name	Error description	Generated by methods
850	API_EC_SMS_INVALID_SESSION	Invalid sms session.
851	API_EC_SMS_MSG_LEN	Invalid sms message length.
852	API_EC_SMS_USER_QUOTA	Over user daily sms quota.
853	API_EC_SMS_USER_ASLEEP	Unable to send sms to user at this time.
854	API_EC_SMS_APP_QUOTA	Over application daily sms quota/rate limit.
855	API_EC_SMS_NOT_REGISTERED	User is not registered for Facebook Mobile Texts
856	API_EC_SMS_NOTIFICATIONS_OFF	User has SMS notifications turned off
857	API_EC_SMS_CARRIER_DISABLE	SMS application disallowed by mobile operator

Application Information Errors

Error number	PHP Constant name	Error description	Generated by methods
900	API_EC_NO_SUCH_APP	No such application exists.

Batch API Errors

Errornumber	PHP Constant name	Error description	Generated by methods
950	API_BATCH_TOO_MANY_ITEMS	Each batch API can not contain more than 20 items
951	API_EC_BATCH_ALREADY_STARTED	begin_batch already called, please make sure to call end_batch first.
952	API_EC_BATCH_NOT_STARTED	end_batch called before begin_batch.
953	API_EC_BATCH_METHOD_NOT_ALLOWED_IN_BATCH_MODE	This method is not allowed in batch mode.

Events API Errors

Error number	PHP Constant name	Error description	Generated by methods
1000	API_EC_EVENT_INVALID_TIME	Invalid time for an event.	events.edit
1001	API_EC_EVENT_NAME_LOCKED	You are no longer able to change the name of this event.	events.edit

Info Section Errors

Error number	PHP Constant name	Error description	Generated by methods
1050	API_EC_INFO_NO_INFORMATION	No information has been set for this user	profile.setInfo
1051	API_EC_INFO_SET_FAILED	Setting info failed. Check the formatting of your info fields.	profile.setInfo

LiveMessage Errors

Errornumber	PHP Constant name	Error description	Generated by methods
1100	API_EC_LIVEMESSAGE_SEND_FAILED	An error occurred while sending the LiveMessage.	liveMessage.send
1101	API_EC_LIVEMESSAGE_EVENT_NAME_TOO_LONG	The event_name parameter must be no longer than 128 bytes.	liveMessage.send
1102	API_EC_LIVEMESSAGE_MESSAGE_TOO_LONG	The message parameter must be no longer than 1024 bytes.	liveMessage.send

Chat Errors

Error number	PHP Constant name	Error description	Generated by methods
1200	API_EC_CHAT_SEND_FAILED	An error occurred while sending the message.

Facebook Page Errors

Error number	PHP Constant name	Error description	Generated by methods
1201	API_EC_PAGES_CREATE	You have created too many pages

Facebook Links Errors

Error number	PHP Constant name	Error description	Generated by methods
1500	API_EC_SHARE_BAD_URL	The url you supplied is invalid

Facebook Notes Errors

Error number	PHP Constant name	Error description	Generated by methods
1600	API_EC_NOTE_CANNOT_MODIFY	The user does not have permission to modify this note.

Comment Errors

Errornumber	PHP Constant name	Error description	Generated by methods
1700	API_EC_COMMENTS_UNKNOWN	An unknown error has occurred.
1701	API_EC_COMMENTS_POST_TOO_LONG	The specified post was too long.
1702	API_EC_COMMENTS_DB_DOWN	The comments database is down.
1703	API_EC_COMMENTS_INVALID_XID	The specified xid is not valid. xids can only contain letters, numbers, and underscores
1704	API_EC_COMMENTS_INVALID_UID	The specified user is not a user of this application
1705	API_EC_COMMENTS_INVALID_POST	There was an error during posting.
1706	API_EC_COMMENTS_INVALID_REMOVE	While attempting to remove the post.

转载于:https://www.cnblogs.com/cosnis/archive/2011/01/06/1927545.html