Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
jQuery JSON-RPC Plugin.
branch: master
Failed to load latest commit information.
README.markdown
jquery.jsonrpc.js README update.

README.markdown

jQuery JSON-RPC Plugin

A JSON-RPC 2.0 implementation for jQuery.

What is JSON-RPC?

JSON-RPC is a lightweight remote procedure call protocol. It's designed to be simple!

Usage

Invocation

$.jsonrpc({
  id: 1,
  url: "foo",
  method: "method",
  params: {
    // pass
  },
  success: function (response) {
    // pass
  },
  fault: function (response, errordata) {
    // pass
  },
  error: function (request, status, error) {
    // pass
  }
});

Parameter detail

  • id: The request id (optional).

  • url: A string containing the URL to which the request is sent.

  • method: A String containing the name of the method to be invoked.

  • params: An object to pass as arguments to the method (optional).

  • success: A function to be called if the request succeeds (optional).

  • fault: A function to be called if the request succeeds (but with error response) (optional).

  • error: A function to be called if the request fails (optional).

Examples

// A RPC call with named parameters
$.jsonrpc({
  url: "/rpc",
  method: "createUser",
  params: {
    name: "John Smith",
    userId: 1000
  },
  success: function (response) {
    // pass
  },
  fault: function (response, errordata) {
    // pass
  },
  error: function (request, status, error) {
    // pass
  }
});

// A Notification
$.jsonrpc({
  url: "/rpc",
  method: "notify",
  params: {
    action: "logout",
    userId: 1000
  }
});

// A Notification using console to debug and with timeout set
$.jsonrpc({
  url: "/rpc"
  method: "notify",
  params: {
    action: "logout",
    userId: 1000
  },
  timeout: 500
});
Something went wrong with that request. Please try again.