EzineArticles API - Member Account Status
Your application may need to retrieve a status of existing EzineArticles member, for example membership level, number of submissions left or a list of alternate author names. This might be helpful if you are developing an application which submits articles on behalf of your customers who are also members of EzineArticles.
Parameters for retrieving Account Status
Note: This method requires Member Authentication.
| Parameter | Possible Values | Purpose | Default | |
|---|---|---|---|---|
| search | account.status | To indicate a request for account status information. | Required | |
| The email address for an EzineArticles Membership Account (Used to login to Membership Account). | Required | |||
| pass | EzineArticles member's password associated with the email. | Required |
Account Status Request Example
http://api.ezinearticles.com/api.php?search=account.status&response_format=xml&email={email address}&pass={password}&key={your api key}
The above API request will return something similar to this:
<ezinearticles_api_response>
<membership_level>Platinum</membership_level>
<submissions_left>Unlimited</submissions_left>
<account_author>Christopher Knight</account_author>
<alternate>
<author>Chris Knight</author>
<author>C. Knight</author>
</alternate>
<response_info>
<time>2008-08-27 16:36:49</time>
<status>200</status>
<search>account.status</search>
<format>xml</format>
</response_info>
</ezinearticles_api_response>
Explanation of Account Status Returned Values
| Value | Represents |
|---|---|
| membership_level | Indicates level of membership. In case this account is suspended, this value will be set to 'Suspended' which means article submissions are not accepted from this account. |
| submissions_left | Number of allowed article submissions. This value might be an Integer representing number of submissions left or if the account is eligible for unlimited submissions this will be set to 'Unlimited'. |
| account_author | The accounts' primary author name. |
| alternate | Contains available alternate author names under this account. |
Response Status Codes
If there is a problem with your API request, an error message will be shown in the format specified by the response_format parameter or in plain text if that parameter is missing.
| Code | Meaning |
|---|---|
| 200 | The request was successful. This code will accompany a response from the API. |
| 404 | No results found. This code will accompany a message explaining that no results were found for your request. |
| 400 | The request was invalid. This code will also be sent if you have exceeded your maximum hourly requests or your API Key is invalid. |
| 500 | The API is experiencing a problem unrelated to your request that prevents it being performed at this time. |