ToDo.md

API definition

What's implemented and what's not...

Links are now broken. Here is the old documentation via the WaybackMachine.

Basis

• APIs are grouped as <ApiGroup />
• Extract UrlPathParameters from <ApiMethod Path="/v1/people/id={MemberToken}" />
• Declare <ReturnType /> and <ApiMethod ReturnType="Person" />
• Add SecureUrls in configuration and use secure-urls=true

Profiles

• user profile of the current user
• user profile by id
• user profile by url
• Connections API
• Connections API: Finding New Connections
• People Search API
• Accessing Out of Network Profiles
• Profile original picture

Groups

Group Memberships for a User

• Group Posts
• Retrieving a Group's Profile Details
• Group Memberships for a User
• PUT a simple group membership request

Retrieving a Group's Discussion Posts

• Retrieving a Group's Discussion Posts
• Show Latest Discussions for a Group
• Show Most Popular Discussions for a Group
• Show Posts a User has Started for a Group
• Show Posts a User has Participated in for a Group
• Show Posts a user is Following for a Group

Creating a Group Discussion Post

• Creating a Group Discussion Post

Interacting with a Discussion Post

• Paginate through all Comments of a Post
• Like/Unlike a Post
• Follow/Unfollow a Post
• Flag a Post as a Promotion or Job
• Delete a Post or Flag as Inappropriate

Interacting with Comments

• Comment Resource Full Field List
• Add a Comment to a Post
• Delete a Comment or Flag as Inappropriate

Suggested Groups for a LinkedIn Member

• Get Suggested Groups for a User
• Remove a Group Suggestion for a User

Companies

For the purposes of testing, we've created a special LinkedIn Company Page that is available for all developers to use. This company page doesn't require the authenticated user making the API call to be an administrator of the company: https://www.linkedin.com/company/devtestco (Company ID 2414183)

• Get operations
  • Companies
  • Get Company shares
• Post Company Share
  • Post a new company share
  • Re-post a share. you provide an attribution/id value instead of a content block
  • check to see if a company has shares enabled
  • check to see if the current viewer is an administrator for a company (so they can share)
  • make a single call to fetch a list of all companies the current user is an administrator of (pagination by 10)
• Historical company statistics
  • Fetching Historical Follower Statistics
  • Fetching Daily Stats
  • Fetching Historical Status Update Statistics
  • Fetching Daily Stats
  • Fetching Statistics for a Specific Company Update
• Company Statistics
  • retrieve statistics for a particular company page
• Targeting Company Shares
  • segment: share-target-reach
  • segment: share-targets
  • segment: share-target
  • segment: code
  • segment: tvalues
  • segment: tvalue
  • Targeting Minimums
  • targeting code: geographies
  • targeting code: company sizes
  • targeting code: job functions
  • targeting code: industries
  • targeting code: seniorities
• Other operations
  • Commenting on a Company Share
  • Liking a Company Share
  • Comment on Company Updates as Company
  • Company Search
  • Retrieving a List of Companies Followed
  • Start Following a Company
  • Stop Following a Company
  • Suggested Companies to Follow

Jobs

Jobs API is a part of our Vetted API Access Program. You must apply here and get LinkedIn's approval before using this API.

• Use Field Selectors to retrieve the specific fields
• Job Fields
• Bookmarking a Job
• Deleting a Job Bookmark
• Retrieving a List of a Member’s Suggested Jobs

Search

• Job Search API
• Refine your search by providing query parameters, such as keywords, job-title, location, and so on

Posting

• Posting a Job
• Posting a Job
• Editing a Job
• Renewing a Job
• Closing a Job

Share and Social Stream

• Posting Shares

• retrieve the member's updates

• retrieve the member's first-degree connection updates

• retrieve updates from 1st degree connections of the authenticated user

• Network Update Types

• how many connections they have one and two degrees away

• Getting More Comments and Likes on a Specific Network Update

• Use a similar syntax to retrive the complete list of people who liked an update

• Adding a Comment or Like to a Network Update

• Network Update Comment XML POST Body

• Post Network Update

Communications

• Invitation

• mailbox

Code generation

• Setup .tt file and generation class
• Generate API groups
• Generate API group
• Generate basic return types
• Generate basic methods
• Support 1 level of field selectors /v1/people/id=12345:(first-name,last-name)
• Support all levels of field selectors
• Collections of ResultType
• Fix generation of sub-fields (ex: location:(name))
• Support entity selectors /v1/people::(~,id=123456,id=456789):(first-name) (ref)
  • API Definition syntax
  • Collection of selectors
  • Generate API method

API other items

• Profile: Some members have profiles in multiple languages. To specify the language you prefer, pass an Accept-Language HTTP header.
• Pagination: start=0, count=500
• /v1/companies?is-company-admin=true

For developers

• Success HTTP codes: 200, 201
• Error HTTP codes: 400, 401, 403, 404, 500
• Async pattern by callbacks for Silverlight and Windows Phone 7ish
• Nuget package

Extra / useless / decorative

• async/await pattern Windows Phone 8ish and RT