Upload Button Icon Add office photos
filter salaries All Filters

42 HR Works Consultancy Jobs

Technical Writer - API Documentation (5-9 yrs)

5-9 years

Technical Writer - API Documentation (5-9 yrs)

HR Works Consultancy

posted 19hr ago

Job Description

Job Description :


The ideal candidate will define and document RESTful APIs for complex systems, ensuring clarity, structure, and adherence to best practices.

This role is perfect for professionals who excel at translating business requirements into detailed API specifications while collaborating with engineering and product teams to enhance API usability and efficiency.

Job Responsibilities :

- Write clear, structured, and detailed API specifications, ensuring comprehensive endpoint documentation.

- Define data schemas, business rules, and validation logic, incorporating cross-resource dependencies.

- Establish error handling standards and validation rules to improve API reliability and consistency.

- Collaborate with engineering and product teams to refine API specifications and ensure seamless integration.

- Develop API documentation using Markdown, OpenAPI/Swagger, JSON Schema, and tools such as Postman or Stoplight.

Job Requirements :

- API Design Expertise - Experience in designing RESTful APIs for complex systems, handling at least 5+ related API resources (e.g., database tables, microservices).

- Data Modeling & Schema Design - Strong understanding of relational and non-relational data structures, constraints, and validation rules.

- API Documentation Standards - Proficiency with Markdown, OpenAPI/Swagger, JSON Schema, and documentation tools like Postman, Stoplight, or ReadMe.io.

- Technical Writing - Ability to write clear, structured, and unambiguous API specifications, covering business rules and edge cases.

- HTTP & REST Protocol Knowledge - Deep understanding of HTTP methods, response codes, headers, authentication, and error handling.

- API Lifecycle Management - Familiarity with API versioning strategies, deprecation policies, and backward compatibility.

- Testing & Validation - Experience with API contract testing, automated validation, and error response consistency.

Domain Knowledge :

- Business Logic Translation - Ability to convert complex business requirements into well-structured API specifications.

- Cross-Resource Rules - Expertise in defining relationships, dependencies, and constraints across multiple API resources.

- Edge Case Handling - Ability to anticipate and document exceptional scenarios and fallback mechanisms.

- Validation Logic- Strong understanding of input validation, error messages, and business rule enforcement.

Soft Skills :

- Exceptional Technical Writing - Ability to produce detailed, precise, and easy-to-understand documentation in professional English.

- Attention to Detail - Ensures that schemas, business rules, and validation logic are meticulously defined.

- Systems Thinking - Understands how API components interact within larger system architectures.

- Problem Solving & Conflict Resolution - Can navigate technical trade-offs, edge cases, and changing requirements effectively.

- Collaboration & Adaptability - Works effectively with engineering, product teams, and stakeholders to refine API specs.

Deliverable Expectations :

- Candidates must demonstrate the ability to create API PRDs that include :

- Complete Data Schemas - All fields, types, constraints, and relationships.

- Comprehensive Endpoint Documentation - Including request/response examples, parameters, and authentication details.

- Business Logic & Validation Rules - Both resource-specific and cross-resource rules.

- Detailed API Endpoints & Error Handling - Covering status codes, failure scenarios, and best practices for API consumers.

- Implementation Guidance - Ensuring development teams can execute API designs without ambiguity.

Total Years Of exp : 5+ years

Mandatory Skills :

- API Documentation : 3 years, Technical Writing - 3 yrs, RestAPI - 3 yrs

- Opportunity : Full-time, contractual, 4 - 5 hours, PST


Functional Areas: Other

Read full job description

Compare HR Works Consultancy with

Randstad

3.8
Compare

Team Lease

3.9
Compare

Innovsource Services

4.0
Compare

ManpowerGroup

3.8
Compare

Aarvi Encon

3.9
Compare

eTeam

3.2
Compare

IMPACT Infotech

3.4
Compare

Teamware Solutions

4.2
Compare

CIEL HR

4.0
Compare

First Advantage

3.8
Compare

Careernet

3.7
Compare

LanceSoft

3.1
Compare

Kutumbh Care

3.9
Compare

Experis IT

3.0
Compare

PeopleStrong

3.4
Compare

Progressive Infovision

4.2
Compare

Talentpro

3.9
Compare

Pyramid IT Consulting

3.0
Compare

Virtual Employee

3.4
Compare

ABC Consultants

3.9
Compare

Similar Jobs for you

Technical Writer at Centific Global Technologies

5-10 Yrs

₹ 15-25 LPA

Technical Writer at Rohini IT Consulting LLP

5-6 Yrs

₹ 30-35 LPA

Technical Writer at Centific Global Technologies

5-10 Yrs

₹ 15-25 LPA

Technical Writer at IT Company

5-8 Yrs

₹ 12-25 LPA

Technical Writer at Tejas Networks Limited

7-15 Yrs

₹ 20-40 LPA

Technical Writer at Zuora,Inc

6-10 Yrs

₹ 25-30 LPA

Documentation at Risk Resources

2-8 Yrs

₹ 15-35 LPA

Technical Writer at Nazztec Private Limited

5-8 Yrs

₹ 15-24 LPA

Technical Writer at Priority Technology Holdings

1-5 Yrs

₹ 10-25 LPA

Technical Writer at Mazenet solution

5-7 Yrs

₹ 15-20 LPA

Technical Writer - API Documentation (5-9 yrs)

5-9 Yrs

19hr ago·via hirist.com

Artificial Intelligence Lead/Manager (5-18 yrs)

5-18 Yrs

2d ago·via hirist.com

Rust Developer (4-8 yrs)

4-8 Yrs

2d ago·via hirist.com

DevOps Engineer - Migration & Deployment (6-15 yrs)

6-15 Yrs

10d ago·via hirist.com

R&D Engineer - HPC System (0-14 yrs)

0-14 Yrs

12d ago·via hirist.com

Recently Viewed

JOBS

Genpact

jodhpur

No Jobs

JOBS

Infosys

Lead

63 jobs

SALARIES

Infosys

Lead

unlock blur L/yr

(167 salaries)

REVIEWS

Infosys

Lead

4.3

(8 reviews)

COMPANY BENEFITS

Amazon

No Benefits

JOBS

Infosys

No Jobs

JOBS

Cognizant

No Jobs

REVIEWS

Genpact

No Reviews

COMPANY BENEFITS

Genpact

No Benefits

REVIEWS

Genpact

No Reviews

write
Share an Interview
How was your last interview experience?
Rate your experience using AmbitionBox
Terrible
Terrible
Poor
Poor
Average
Average
Good
Good
Excellent
Excellent
Sorry, this job is no longer available!