Azblink API for Sending XMPP Messages via HTTP POST

Size: px

Start display at page:

Download "Azblink API for Sending XMPP Messages via HTTP POST"

Madeleine Farmer
5 years ago
Views:

1 Azblink API for Sending XMPP Messages via HTTP POST Abstract: This document is to describe the API of Azblink SBC for sending XMPP messages via HTTP POST. This is intended for the systems or the devices with limited resources. This interface is only provided for sending XMPP messages, not receiving them. Introduction XMPP client programs are available on many mobile devices. To take advantage of this, some devices can send messages to those XMPP clients by using this simple HTTP POST interface for sending critical alerts. XMPP itself also allows to send messages across domains or different machines. Those will be taken care by the server; the device itself should only focus on sending messages. To use the HTTP POST interface, the device needs to provide the account and password for authentication along with the destination that it wishes to deliver the messages.

2 Sample HTML Codes for Testing Setup The following is the sample HTML codes; you have to tailor the place for submitting HTTP POST in HTML form ( the part action=" ). The actual place to submit http request is subject to changes. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" " g/tr/xhtml1/dtd/xhtml1-transitional.dtd"> <html xmlns=" > <meta http-equiv="content-type" content="text/html; charset=utf-8"> <head> <title> send message to XMPP server via HTTP POST</title> </head> <body> <form action=" method="post"> Account: <input type="text" name="acct" > <br> Password: <input type="text" name="password" > <br> Domain: <input type="text" name="domain" > <br> Destination: <input type="text" name="dest" > <br> Message: <input type="text" name="message" > <br> <input type="submit"> <br> </form>

3 Please note that XMPP message only can be seen after you accept the friend request from the other party. Thus, you have to use the other XMPP client programs to make both parties on the friend list of each other. Otherwise, you will not be able to see the messages. This HTTP POST interface only takes care of sending messages. The description of the variables in html form is as follows: Account (acct) : account on the server Password (password): password on the server Domain (domain) : domain of the account being used Destination (dest) : destination to send XMPP message (e.g test@exam ple.com) Message (message) : XMPP message to send to the other end And the "action" in HTTP form needs to be tailor to the place of the PHP wrapper. Sample Codes for C Programming Language /* This program is used to send http "POST". Usage:./httpPost hostip port action post_string Example:./httpPost /p/xmppwebproxy.php 'acct=test&passwor d=test123&domain=haha.com&dest=lala@haha.com&message=this is test 1' */ #include <stdio.h> #include <stdlib.h> #include <unistd.h> #include <errno.h> #include <string.h> #include <netdb.h> #include <sys/types.h> #include <netinet/in.h> #include <sys/socket.h> #include <arpa/inet.h> ///////////////////////////////// // get sockaddr, IPv4 or IPv6: ///////////////////////////////// void *get_in_addr(struct sockaddr *sa) if (sa->sa_family == AF_INET)

4 return &(((struct sockaddr_in*)sa)->sin_addr); return &(((struct sockaddr_in6*)sa)->sin6_addr); int main(int argc, char **argv ) char host[128]; char portno[128] ; struct hostent *server; struct addrinfo hints, *servinfo, *p ; int rv; int sockfd, bytes, sent, received, total; char message[4096]; char response[32768]; char page[1024]; char poststring[1024]; char s[inet6_addrstrlen]; if (argc < 5) printf("%s hostip port action post_string \n", argv[0]); printf(" Example: %s /p/xmppwebproxy.php 'acct=test& password=test123&domain=haha.com&dest=lala@haha.com&message=this is test 1'\n", argv[0] ); exit(0); sprintf( host, "%s", argv[1] ); sprintf( portno, "%s", argv[2] ); sprintf( page, "%s", argv[3] ); sprintf( poststring, "%s", argv[4] ); /* fill in the parameters */ sprintf(message,"post %s HTTP/1.0\r\nHost: %s\r\ncontent-type: application/x -www-form-urlencoded\r\ncontent-length: %d\r\n\r\n%s\r\n", page, host, strlen(po ststring), poststring); memset(&hints, 0, sizeof hints); hints.ai_family = AF_UNSPEC; hints.ai_socktype = SOCK_STREAM; if ((rv = getaddrinfo(host, portno, &hints, &servinfo))!= 0) fprintf(stderr, "getaddrinfo: %s\n", gai_strerror(rv)); return 1; for(p = servinfo; p!= NULL; p = p->ai_next) sockfd = socket(p->ai_family, p->ai_socktype, p->ai_protocol); if ( sockfd == -1) perror("client: socket"); continue;

5 if (connect(sockfd, p->ai_addr, p->ai_addrlen) == -1) close(sockfd); perror("client: connect"); continue; break; if (p == NULL) fprintf(stderr, "client: failed to connect\n"); return 2; inet_ntop(p->ai_family, get_in_addr((struct sockaddr *)p->ai_addr), s, sizeof s); freeaddrinfo(servinfo); /* send the request */ total = strlen(message); bytes = write(sockfd,message,total); if (bytes < 0) perror("error: socket write"); exit(0); /* receive the response */ memset(response,0,sizeof(response)); bytes = read(sockfd,response,4096); response[bytes]='\0'; close(sockfd); /* process response */ printf(" \n"); printf("response:\n"); printf("bytes received %d \n", bytes ); printf("%s\n",response); return 0;

ENGN8637. Advanced Topics in Communications. Your Title

ENGN8637. Advanced Topics in Communications. Your Title ENGN8637 Advanced Topics in Communications Your Title Your name uxxxxxxxx@anu.edu.au Research School of Engineering, ANU submitted on 18/March/2018 Contents 1 Introduction 1 2 A New Section 3 3 Yet another