Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Branch: master
Fetching contributors…

Cannot retrieve contributors at this time

99 lines (80 sloc) 1.915 kB

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
});
Jump to Line
Something went wrong with that request. Please try again.