User:Ethan: Difference between revisions

From xat wiki
No edit summary
No edit summary
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages />
__NOTOC__
SetScroller is a feature aimed at advanced users who want to set the chat scroller automatically from their server. e.g. showing tweets, displaying now/next on their radio station.


<translate>
To use it, you will need your chat's '''id''' and '''pw''', which can be found in  your chat's Extra features link.


<!--T:64-->
==Usage==
Here are a list of error messages on xat and what they mean.


== Account Management Errors == <!--T:41-->
You can use the API manually via a web page here: http://xat.com/web_gear/chat/SetScroller.php


'''Example''':
{{pre|<nowiki>http://xat.com/web_gear/chat/SetScroller.php?Message=Hello%20all!&id=12345&pw=1234567890</nowiki>}}
Or you can access the API using a programming language.


<!--T:65-->
'''Example of how to access the API in PHP''':
*E4 - Already registered
{{pre|<nowiki>
$message = "Hello all!"
$id = 12345;
$pw = 1234567890;


<!--T:66-->
$url = "http://xat.com/web_gear/chat/SetScroller.php?Message=".urlencode($message)."&id={$id}&pw={$pw}";
*E6 - Username is taken.
$ch = curl_init();
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_TIMEOUT, 60);
$content = curl_exec ($ch);
print "$content\n";
curl_close ($ch);
</nowiki>
}}


<!--T:67-->
'''Notes''':
*E7 - Email is already in use.


<!--T:68-->
*You are limited to 1 update every minute.
*E13 - Not found


<!--T:69-->
*The above uses the GET HTTP method, POST will also work.
*E14 - Wrong password


<!--T:70-->
*If you reset your chat you will need to update your software to go to the new ID and PW. If you change your group password you'll need to update to use the new pass.
*E15 - Email is not valid.
 
<!--T:71-->
*E17 - Email not found, or cannot change username.
 
<!--T:101-->
*E19 - Sorry, name already taken.
 
<!--T:111-->
*E20 - Cannot delete account due to username change or recently registered.
 
<!--T:108-->
*E21 - Turn off authentication before deleting an account.
 
<!--T:72-->
*E22 - Check your email to login and delete your account.
 
<!--T:91-->
*E23 - You cannot delete an account that has xats, days or powers.
 
<!--T:73-->
*E25 - Incorrect Username/Email or Password
 
<!--T:74-->
*E26 - Account not activated
 
<!--T:100-->
*E27 - Email has been blocked.
 
<!--T:94-->
*E28 - Account deleted. (Open a ticket.)
 
<!--T:76-->
*E29 - Locked out
 
<!--T:77-->
*E30 - Check your email. (Security check.)
 
<!--T:78-->
*E31 - Cannot turn account locking on. Location update may be required.
 
<!--T:95-->
*E33 - Please set the clock on your device.
 
<!--T:96-->
*E34 - Failed to activate authorization. Try again.
 
<!--T:97-->
*E35 - Incorrect authentication code.
 
<!--T:79-->
*E36 - Login requires authenticator code.
 
<!--T:98-->
*E37 - Enter authenticator code to verify request to disable Account Authentication.
 
<!--T:80-->
*E39 - Password was too short. Must be at least 6 characters long.
 
<!--T:81-->
*E40 - Passwords are not the same.
 
<!--T:109-->
*E42 - Email is not valid. Registering a xat account. Remember to put the email's provider name.
 
<!--T:93-->
*E43 - Email is blocked (Register with a different email)
 
<!--T:110-->
*E44 - Bad user ID. Please login and try again. You must be registered to view the buy page.
 
<!--T:82-->
*E45 - Login and try again.
 
<!--T:83-->
*E46 - ID was not found. Make a ticket to get the k2 repaired.
 
<!--T:84-->
*E47 - Name is too long or contains bad letters. Must be between 10-18 characters.
 
<!--T:85-->
*E48 - Name is not allowed.
 
<!--T:86-->
*E49 - First letter must not be a number.
 
<!--T:87-->
*E50 - Bad user ID. Sorry you can't register.
 
<!--T:103-->
*E51 - The ID has been registered before or was deleted (email reused) and can no longer be registered.
 
<!--T:92-->
*E55 - Account was deleted. (Open a ticket.)
 
<!--T:99-->
*E64 - Check your email. (Security check.)
 
==System Errors/Blocks== <!--T:104-->
 
<!--T:105-->
*System problem (1): Error when creating a group. Complete the reCAPTCHA and accept the Terms of Service, and then try again.
 
<!--T:88-->
*System problem (2): Cannot register that ID. You are trying to activate the ID from a different location than where it was registered.
 
<!--T:89-->
*System problem (10): Cannot register that ID.
 
<!--T:4-->
*System problem (11): Cannot delete account due to transfer block.
 
<!--T:5-->
*System problem (12): Cannot delete account or change name due to transfer hold.
 
<!--T:6-->
*System problem (13): Login with locking/protection turned ON.
 
<!--T:7-->
*System problem (14): Login is currently undergoing maintenance. 
 
<!--T:8-->
*System problem (20): You need to relogin.
 
<!--T:9-->
*System problem (21): You need to redo the trade or relogin.
 
<!--T:10-->
*System problem (23): User has [[mint]] power.
 
<!--T:11-->
*System problem (25): Multiple features have been disabled due to breaking terms of service or security.
 
<!--T:12-->
*System problem (26): The recipient of your transfer has a transfer block.
 
<!--T:13-->
*System problem (27): You have too many days and need to trade some or use [[Powers|DX]].
 
<!--T:14-->
*System problem (28): Trying to send too many xats/days (max 100,000 xats).
 
<!--T:15-->
*System problem (29): Other user is likely using third-party programs to edit the trade.
 
<!--T:16-->
*System problem (30): You cannot buy powers.
 
<!--T:17-->
*System problem (31): You cannot promote a group.
 
<!--T:102-->
*System problem (32): Cannot buy power(s) because all account transactions are suspended.
 
<!--T:18-->
*System problem (33): Temporary transfer hold. Blocks only outgoing transfers, and trades.
 
<!--T:19-->
*System problem (40): Trade is currently undergoing maintenance.
 
<!--T:20-->
*System problem (42): Cannot trade this power.
 
<!--T:21-->
*System problem (43): Cannot trade 1 day for 1 day.
 
<!--T:90-->
*System problem (47): Cannot transfer to celebrity (trading works).
 
<!--T:22-->
*System problem (49): The user is no longer online.
 
<!--T:23-->
*System problem (51): Attempting to trade to a Bot or a mobile user.
 
<!--T:24-->
*System problem (55): Your account is held indefinitely. Blocks all outgoing trades and transfers.
 
<!--T:25-->
*System problem (56): The recipient of your transfer has a transfer block.
 
<!--T:26-->
*System problem (99): Server issues. Try again later.
 
==Group Errors== <!--T:27-->
 
<!--T:28-->
*Not available (1): Group has not been deemed inactive (must be 3 months of no staff).
**You cannot buy the chat that is not inactive.
 
<!--T:29-->
*Not available (5): Group has been [[Chat blocks|delisted]].
**The chat is most likely been delisted due to breaking the xat terms of serive, promotion or has broken the CSS Guidelines.
 
<!--T:30-->
*Not available (6): Group has already been purchased.
 
<!--T:31-->
*Not available (7): Group was created less than 6 months ago.
 
<!--T:32-->
*Not available (8): Group was deleted.
**Create a [[ticket]] under ''Chat Block'' help topic to find out the reason why the chat has been deleted?
 
<!--T:33-->
*Not available (9): Group has a low ID.
 
<!--T:34-->
*Not available (11): Group has not been deemed inactive (must be 3 months of no staff).
 
<!--T:35-->
*Not available (12): Group name has a reserved word.
**Try creating group with another chat name again.
 
<!--T:36-->
*Not available (13): Group cannot be purchased.
 
==Short Names Errors== <!--T:37-->
 
<!--T:38-->
*Name taken (1): Sorry, name already taken.
**Name cannot be enabled again.
 
<!--T:39-->
*Name taken (2): Sorry, name already taken.
**Name can be enabled again, contact http://xat.com/ticket if you are paid and would like it.
 
<!--T:40-->
*Not allowed: Reserved word e.g. "xat" or a swear word in the name.
**Make sure you're using an appropriate name.
 
==Ticket System Errors== <!--T:106-->
 
<!--T:107-->
*403 - Your email is on the ban list (cannot create ticket).
 
</translate>

Revision as of 12:35, 4 September 2016

SetScroller is a feature aimed at advanced users who want to set the chat scroller automatically from their server. e.g. showing tweets, displaying now/next on their radio station.

To use it, you will need your chat's id and pw, which can be found in your chat's Extra features link.

Usage

You can use the API manually via a web page here: http://xat.com/web_gear/chat/SetScroller.php

Example:

http://xat.com/web_gear/chat/SetScroller.php?Message=Hello%20all!&id=12345&pw=1234567890

Or you can access the API using a programming language.

Example of how to access the API in PHP:

$message = "Hello all!"
$id = 12345;
$pw = 1234567890;

$url = "http://xat.com/web_gear/chat/SetScroller.php?Message=".urlencode($message)."&id={$id}&pw={$pw}";
$ch = curl_init();
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_TIMEOUT, 60);
$content = curl_exec ($ch);
print "$content\n";
curl_close ($ch);

Notes:

  • You are limited to 1 update every minute.
  • The above uses the GET HTTP method, POST will also work.
  • If you reset your chat you will need to update your software to go to the new ID and PW. If you change your group password you'll need to update to use the new pass.