/question/post/{context}
- Mount Point: /rest/question/post/{context}
The following operations are supported on this resource:
POST
Post a new question for real estate agents to answer.
IMPORTANT NOTICE: this API has been relocated to http://api.realtybaron.com/answersParameters
| name | description | type | default |
|---|---|---|---|
| context | A context type which determines how 'location' is interpreted. | path | |
| location | A free-text value representing the location where the question should be posted. Almost any property, ZIP, city, or metro specification will work, e.g "2407 Euclid Avenue, Austin, TX 78704", "78704", "Austin, TX", "Austin-San Marcos". However, it must make sense with respect to the context. | form | |
| fname | User's first name | form | |
| lname | User's last name | form | |
| User's email address | form | ||
| subject | The basic question | form | |
| body | Details of question | form | |
| tag | One or more tags which describe the question, i.e. "mortgage" or "foreclosure" or "buying" | form | |
| tou | terms of use | form | |
| notify_me | If true, we'll send an email to the inquirer each time an answer to the question is posted | form | |
| open_days | The number of days question will be open for new answers. Defaults to 3 days. | form | 3 |
| redo_url | The location on your website where the question can be re-phrased. If the question is rejected by moderators, we'll embed this URL in an email to the user asking that he/she make corrections and re-submit their question. The email will appear to be from your application. For example, http://www.yourwebsite.com/redo?question={0} will send user to http://www.yourwebsite.com/redo?question=1. | form | |
| answer_url | The location on your website where answers to the question will be viewed. We'll replace the variable "{0}" with the question's unique ID and embed the resulting URL in an email to the user notifying he/she that a new answer is available. For example, http://www.yourwebsite.com/answers?question={0} will send user to http://www.yourwebsite.com/answers?question=1. | form | |
| profile_url | The location on your website where profiles can be viewed. We'll replace the variable "{0}" with the profile's unique ID and embed the resulting URL in answer badges whose links are not enhanced with advertising. For example, http://www.yourwebsite.com/profile?profile={0} will send user to http://www.yourwebsite.com/profile?profile=1. See http://www.agentrank.com/api for documentation on the profile service endpoint. | form | |
| api_key | This identifies your application. Please email help@realtybaron.com to request an API key. | form |
Output Payload
| element | produceable content type(s) |
|---|---|
| response (XML) | |
| description | |
| api response | |