Aviator logo

Getting Started Edit

Welcome to our API.

This API document is designed for developer advocate research.

You’ll succeed if you do this.

Here’s some useful information.

Something bad will happen if you do this.

/advocates Edit

List all advocates

Parameters
limit
Limit the number of advocates returned

This call will return a maximum of 100 advocates

$.get("http://api.devrel.com/advocates/", { "token": "YOUR_APP_KEY"}, function(data) {
  alert(data);
});

r = requests.get("http://api.devrel.com/advocates/", token="YOUR_APP_KEY")
print r.text

var request = require("request");
request("http://api.devrel.com/advocates?token=YOUR_APP_KEY", function (error, response, body) {
if (!error && response.statusCode == 200) {
  console.log(body);
}

curl http://sampleapi.devrel.com/advocates?key=YOUR_APP_KEY

[
  {
    "id": "jono",
    "name": "Jono Bacon",
    "description": "Jono Bacon is a leading community strategy, management, and execution author, consultant, and speaker.",
    "available": false
  },
  {
    "id": "mary",
    "name": "Mary Thengvall",
    "description": "Mary Thengvall is a connector of people at heart, both personally and professionally.",
    "available": false
  },
  {
    "id": "yitzi",
    "name": "Yitzi Ginzberg",
    "description": "Yitzi Ginzberg is a developer, teacher, and community organizer, with a passion for spreading knowledge.",
    "available": true
  }
]

{
  "error": true,
  "message": "Unauthorized"
}

/advocates/:id Edit

Get Advocate

Returns a specific advocate from your collection

$.get("http://api.myapp.com/advocates/yitzi", {
  token: "YOUR_APP_KEY",
}, function(data) {
  alert(data);
});

r = requests.get("http://api.devrel.com/advocates/yitzi", token="YOUR_APP_KEY")
print r.text

var request = require("request");
request("http://api.devrel.com/advocates/yitzi?token=YOUR_APP_KEY", function (error, response, body) {
if (!error && response.statusCode == 200) {
  console.log(body);
}

curl http://sampleapi.devrel.com/advocates/yitzi?key=YOUR_APP_KEY

{
  "user": "yitzi",
  "degree": "BSc Computer Science",
  "college": "Jersalem College of Technology",
  "email": "hello@yitzi.dev",
  "linkedin": "yitzi.dev/li",
  "employer" : "Sifra",
  "position" : "Lead Backend Developer",
  "resume" : "yitzi.dev/resume",
  "note": "Grab if available!"
}

{
  "error": true,
  "message": "Advocate doesn't exist"
}

/advocates/:id/:jobs Edit

Get Advocate's Work experience

Returns the work experience of a specific advocate

$.get("http://api.myapp.com/advocates/yitzi/jobs", {
  token: "YOUR_APP_KEY",
}, function(data) {
  alert(data);
});

r = requests.get("http://api.devrel.com/advocates/yitzi/jobs", token="YOUR_APP_KEY")
print r.text

var request = require("request");
request("http://api.devrel.com/advocates/yitzi/jobs?token=YOUR_APP_KEY", function (error, response, body) {
if (!error && response.statusCode == 200) {
  console.log(body);
}

curl http://sampleapi.devrel.com/advocates/yitzi/jobs?key=YOUR_APP_KEY

[
  {
    "id": "sifra",
    "position": "Lead Developer and Advocate",
    "company": "Sifra Digital",
    "website": "sifradigital.com",
    "dateStarted": "Feb 2016",
    "currentPosition": true
  },
  {
    "id": "start",
    "position": "Community Manager",
    "company": "Start Bet Shemesh",
    "dateStarted": "Feb 2018",
    "currentPosition": true
  },
  { "id": "maoftech",
    "position": "Advisory board member",
    "company": "MaofTech accelerator",
    "website": "betshemesh.maof-tech.com",
    "dateStarted": "Dec 2018",
    "currentPosition": true
  }
]

{
  "error": true,
  "message": "Advocate has no experience, RUN AWAY!"
}

/advocates/:id/projects/community Edit

Get Advocate's Community Projects

Returns the community building experience of a specific advocate

$.get("http://api.myapp.com/advocates/yitzi/projects/community", {
  token: "YOUR_APP_KEY",
}, function(data) {
  alert(data);
});

r = requests.get("http://api.devrel.com/advocates/yitzi/projects/community", token="YOUR_APP_KEY")
print r.text

var request = require("request");
request("http://api.devrel.com/advocates/yitzi/projects/community?token=YOUR_APP_KEY", function (error, response, body) {
if (!error && response.statusCode == 200) {
  console.log(body);
}

curl http://sampleapi.devrel.com/advocates/yitzi/projects/community?key=YOUR_APP_KEY

[
  {
    "name": "Community Project Nights",
    "position": "Organizer",
    "description": "Organize and facilitate twice monthly meetups where developers and community managers work to build community and software in Bet Shemesh",
    "website": "http://bit.ly/PROJECTGALLERY"
  },
  {
    "name": "Google Developer Challenge Meetup",
    "position": "Organizer",
    "description": "Organized meetups for the Google Developer Challenge participants at Google Campus TLV",
    "notes": "Featured in the Udacity international newsletter. We were the first in person meetup for the course and inspired similar meetups worldwide!"
  },
  {
    "name": "Isreasy",
    "position": "Developer",
    "description": "I created this app to provide an easy to use, one stop shop resource for anglo job hunters in Israel.",
    "url": "bit.ly/DREAMJOBISRAEL"
  }
]

{
  "error": true,
  "message": "Advocate has no interpersonal skills, RUN AWAY!"
}

/advocates/:id/projects/software Edit

Get Advocate's Software Projects

Returns the software development experience of a specific advocate

$.get("http://api.myapp.com/advocates/yitzi/projects/software", {
  token: "YOUR_APP_KEY",
}, function(data) {
  alert(data);
});

r = requests.get("http://api.devrel.com/advocates/yitzi/projects/software", token="YOUR_APP_KEY")
print r.text

var request = require("request");
request("http://api.devrel.com/advocates/yitzi/projects/software?token=YOUR_APP_KEY", function (error, response, body) {
if (!error && response.statusCode == 200) {
  console.log(body);
}

curl http://sampleapi.devrel.com/advocates/yitzi/projects/software?key=YOUR_APP_KEY

[
  {
    "name": "Anylaw",
    "role": "Lead developer",
    "responsibilities": "crawlers, parsing, classification, and search",
    "description": "AnyLaw was established to provide a no-cost alternative solution to the unnecessary – and exclusionary — expense of legal research",
    "website": "anylaw.com",
    "press": "Featured on forbes.com at forbes.com/sites/maryjuetten/2019/01/22/free-legal-research-for-all-anylaw",
    "technologies": "crawler4j, Elastic, PostgreSQL"  
  },
  {
    "name": "The English Club",
    "position": "Android Lead",
    "description": "Responsible for UI update of popular educational game",
    "website": "englishclubapp.com",
    "app": "play.google.com/store/apps/details?id=com.englishclubapp.englishclub",
    "press": "Featured in the Maariv (Israel's second top selling newspaper) in honor of international children's day as one of five apps representative of Israel's Edtech innovation",
    "technologies": "Android, Java, Gradle"
  },
  {
    "name": "BimiLeap",
    "position": "Android Lead, Payments integration",
    "description": "Knowledge creation app! Founded by Dr. Howard Moskowitz",
    "press": "Malcolm Gladwell's TED talk about the discoveries of our founder that the app is based on ted.com/talks/malcolm_gladwell_on_spaghetti_sauce",
    "technologies": "Freemarker, Email integration, Payments flow (Stripe API)"
  }
]

{
  "error": true,
  "message": "Advocate has no dev skillz, RUN AWAY!"
}

/advocates/:id/:skills Edit

Get Advocate's Skills

Returns the skills of a specific advocate

$.get("http://api.myapp.com/advocates/yitzi/skills", {
  token: "YOUR_APP_KEY",
}, function(data) {
  alert(data);
});

r = requests.get("http://api.devrel.com/advocates/yitzi/skills", token="YOUR_APP_KEY")
print r.text

var request = require("request");
request("http://api.devrel.com/advocates/yitzi/skills?token=YOUR_APP_KEY", function (error, response, body) {
if (!error && response.statusCode == 200) {
  console.log(body);
}

curl http://sampleapi.devrel.com/advocates/yitzi/skills?key=YOUR_APP_KEY

[
  {
    "skill": "learning new technologies",
    "description": "Yitzi picks up new technologies rapidly and quickly finds creative and fun ways to put them to use",
    "examples": "As a development lead on projects ranging from education to legal research and more Yitzi has proven himself capable of picking up new technologies on the fly and implementing them with a focus on best practice. In the heat of action Yitzi has learnt Android, Java, PostgreSQL, Elastic, and much more. Yitzi is a tireless tinkerer who wil not put down a new technology until he masters it!"
  },
  {
    "skill": "Boiling Hi-tech down to its fundamental ingredients and presenting complex concepts to audiences of all levels at their level",
    "description": "Years of working directly with clients as well as presenting tech workshops for all ages has helped Yitzi to hone his teaching methods.",
    "examples": "Yitzi runs the popular workshops at TeamUP Israel that teaches tech (RasPi, Android..) to people of all ages."
   }
]

{
  "error": true,
  "message": "Advocate has no skillz, RUN AWAY!"
}