API Documentation

Notifier API

The Notifier API is used to send exception and error data to our service. It is used in our Ruby (Ruby on Rails) and PHP (+ Zend Framework) exception notifier plugins — feel free to implement your own notifiers in your language of choice.


The API-namespace to use is https://exceptiontrap.com/api/notifier/v1 (you can use http too). As you can see, the current API version is 1.0.

All data sent must be in JSON format.

Authentication is handled by sending your API key as a HTTP header field named x-api-key. Your API key can be found by logging into your Exceptiontrap account, selecting the project and clicking the "Setup" link at the top.

Send a problem / error / exception

You can send errors and exceptions via /problems.json. See a sample request and the accepted attributes here:

POST /problems.json
Content-type: application/json
x-api-key: b17a27b3f141c69d7552
  "problem": {
    "name": "SyntaxError",
    "message": "/app/controllers/home_controller.rb:5: syntax error, unexpected tIDENTIFIER, expecting keyword_end",
    "location": "HomeController(5)",
    "request_params": {
      "q": "foo",
      "me": "too",
      "...": "..."
    "request_remote_ip": "",
    "request_session": {
      "session_id": "BAh7B0kiD3Nlc3Npb25faWQGOgZFRkkiJTAzMWRiNTExOTU0Mj",
      "user_credentials": "111814c12f51436e52d94fa224240fc9328e0f0ef3abd2cb17e21a597",
      "...": "..."
    "request_uri": "",
    "root": "/srv/apps/rails-sample",
    "trace": [
      "activesupport (3.2.9) lib/active_support/dependencies.rb:454:in `load'",
      "activesupport (3.2.9) lib/active_support/dependencies.rb:454:in `block in load_file'",
      "activesupport (3.2.9) lib/active_support/dependencies.rb:593:in `new_constants_in'",
    "app_environment": "production",
    "environment": {
      "HTTP_ACCEPT_CHARSET": "ISO-8859-1,utf-8;q=0.7,*;q=0.3",
      "HTTP_VERSION": "HTTP/1.1",
      "SERVER_SOFTWARE": "nginx/latest",
      "SERVER_NAME": "thor",
      "...": "..."
    "request_components": {
      "module": "default",
      "controller": "home",
      "action": "show"

A cURL request would look like this (assumed you have the data saved in a file called sample.json):

curl https://exceptiontrap.com/notifier/api/v1/problems.json \
  -X POST --data-binary "@sample.json" \
  -H "Content-type: application/json" \
  -H "x-api-key: b17a27b3f141c69d7552"

The required attributes are:

  • name
  • message

But we would recommend to send all the information available to give you a better experience when you have to resolve the error and want to understand what's going on.

Grouping of the errors is performed on the following attributes

  • name
  • location
  • app_environment
  • request_components (module, controller, action)

Notifier Libraries