Updates
- 6 Sep 2002 - The service used to return a fault message,
even though the IM was sent correctly. This is fixed
now. Thanks to Ron
Lue-Sang who reported this issue.
FAQ
-
What is this about?
This page documents a Web service
that can be used to send Yahoo instant messages.
-
What is a Web service?
Web services are software
components that that can be called using well defined, simple and
cross-platform protocol. See the
XMethods
Web site to learn more about Web services.
-
Where is the WSDL for this service?
http://www.scdi.org/~avernet/webservice/yim.wsdl
-
What if my tool doesn't support WSDL?
You can call
this service using directly the SOAP API available in your favorite
language. You just need to know that the endpoint is
http://www.scdi.org/~avernet/webservice/,
the operation name is
sendYIM, its namespace is
urn:avernet
and its argument names are
to (who the message is sent to) and
body (the text of the message).
-
What if my question isn't covered on this page?
Please contact me by email at
avernet@scdi.org.
Statistics
 |
- Total number of instant messages sent since August 2002:
154,782
- This statistics is updated every day.
Last update: Wed Dec 20 11:40:07 PST 2006
|
Sample Code
- Here is an example written in
PHP using the standard
PEAR::SOAP
library:
require_once("SOAP/Client.php");
$soapclient = new SOAP_Client
("http://localhost/~avernet/webservice/");
$soapclient->call("sendYIM",
array("to" => "someone", "body" => "Hey, there!"),
"urn:avernet");
- If you are using AST.NET, see this this
article over at dotnetjunkies.com. It explains how to call a Web
service by first generating a proxy class with the
wsdl.exe tool.
Restrictions
You cannot use this service for commercial purposes. You cannot
use this service for reasons other than experimenting. This service is available
for free to anyone, please help us keep it this way by not abusing it.
To prevent any abuse and to play fair with the Yahoo servers,
we are send a maximum of one message every 10 seconds. Also, any single client
cannot send more than 100 messages every day. If you want you want to use
this service for commercial reasons and/or you would like some of there restrictions
to be waived, please just contact me at
avernet@scdi.org.
Try it out
You can fill out and submit the form below to test this Web service.
