
Closed
Posted
I want to build a small yet realistic REST API that I can use to showcase my API-testing skills in Postman and Swagger. The core requirement is a “Create” endpoint—think of adding a new record (for instance, a new product, article, or contact) and returning the freshly saved object. That single operation is enough for my current practice, but it must be production-style: proper request validation, clear response bodies, sensible status codes, and graceful error handling. Security matters as well, so I’d like the endpoint protected with JWT authentication. A working login flow that issues the token is essential; any other authentication methods can stay out of scope. To guide my testing, please annotate everything with Swagger / OpenAPI so I can explore each field, header, and expected response directly in the browser. I’ll be creating a Postman collection that automates positive and negative tests, so the API has to be easy to import into Postman (environment variables for the base URL and token are fine). Deliverables • Source code for the API (any language or framework you prefer) • Valid OpenAPI 3.x specification exposed at /swagger or /docs • Running endpoint for the Create operation with JWT protection • Seed data or simple in-memory storage so the call returns meaningful results • Brief read-me explaining setup, environment variables, and how to obtain the JWT Once everything is in place, I’ll handle the Postman scripting myself; I just need a solid, well-documented API foundation to test against and later add to my portfolio.
Project ID: 40738634
300 proposals
Remote project
Active 50 mins ago
Set your budget and timeframe
Get paid for your work
Outline your proposal
It's free to sign up and bid on jobs
300 freelancers are bidding on average €15 EUR/hour for this job

Hi there, I can build a small but production-style REST API specifically designed for showcasing and testing API skills in Postman and Swagger. I’ll keep the scope focused while making validation, authentication and error handling realistic. I’ll also structure the API so you can easily build positive, negative, authentication and validation test cases in Postman. I’ll Build: ✦ JWT login endpoint + token generation ✦ Protected Create endpoint ✦ Request validation & meaningful responses ✦ Correct HTTP status codes ✦ Structured error handling ✦ In-memory/seed data storage ✦ OpenAPI 3.x documentation at /swagger or /docs ✦ JWT authorization header documented ✦ Environment-ready base URL/token setup ✦ Clean source code + setup README ➡️ Suggested Stack: FastAPI + Python + SQLite/in-memory storage — lightweight, well documented and excellent for API testing. ❓Do you prefer Python/FastAPI, Node.js/Express, or are you open to the stack choice? ❓Would you like SQLite persistence or simple in-memory storage for the showcase? ♾️ That's all for now. I can commence immediately. I am open to a chat to proceed forward with the next step. Thank You.
€12 EUR in 40 days
10.0
10.0

Hello, We carefully studied the description of your project and we can confirm that we understand your needs and are also interested in your project. Our team has the necessary resources to start your project as soon as possible and complete it in a very short time. We are 25 years in this business and our technical specialists have strong experience in PHP, Java, JavaScript, Python, Software Architecture, Node.js, API Development, API Testing, REST API and other technologies relevant to your project. Please, review our profile https://www.freelancer.com/u/tangramua where you can find detailed information about our company, our portfolio, and the client's recent reviews. Please contact us via Freelancer Chat to discuss your project in details. Best regards, Sales department Tangram Canada Inc.
€22 EUR in 5 days
9.0
9.0

Having worked as a Python and JavaScript developer for over 5 years, completing a wide range of successful API projects, I am confident that I am the ideal candidate to build your Postman-testing REST API. My experience in full stack web development and proficiency in languages such as Python, JavaScript, and Node.js perfectly aligns with your project needs. Moreover, I have developed APIs utilizing technologies like Django and Flask that would be useful for creating API tests for your project. In addition to my technical skills, I am an expert in Web Scraping and Automation- important elements in capturing the expected responses, headers, and error handling aspects you specified. This experience will enable us to ensure your API is valid and well-documented using OpenAPI- as per your requirements- while also enhancing its ease-of-use within the Postman collection you want to create. Understanding the importance of security within our deliverables, implementing JWT authentication for your endpoint is well within my skill-set. Moreover, since data generation is necessary for effective testing, I'll ensure there's a seed data mechanism or simple in-memory storage integrated into the API so that it returns meaningful results akin to a real-world scenario. I am highly motivated to provide you with not just a "production-style" Create endpoint but a fully-rounded project containing all your specifications for future reference and portfolio enhancement.
€15 EUR in 40 days
8.2
8.2

Hello, Rather than a basic CRUD demo, I’d suggest building a compact, production-style API-testing playground that gives your Postman portfolio something meaningful to showcase. I can build it with FastAPI, including JWT authentication, /login, and a protected POST /products endpoint with strict validation, conflict handling, consistent error schemas, and proper HTTP status codes. I’ll document everything in OpenAPI 3.x with Bearer auth, schemas, headers, validation, and error responses via Swagger UI at /docs. I’ll also include seed data, environment configuration, and a clear README for setup and JWT usage. You’ll have a clean, reliable API foundation that’s ready for Postman automation and easy to extend as your testing portfolio grows. I’d be happy to build it with your future testing workflow in mind. Best, Niral
€13 EUR in 40 days
8.1
8.1

Hi, I will build your practice REST API using Node.js and Express with in memory storage so every create operation saves and returns the new object cleanly. The setup will include a login route that generates a valid JWT token, which you can then pass in the request header to test the protected create endpoint. I will also add full request validation so bad data triggers clear error messages and the right status codes. To make your Postman collection easy to build, I will attach Swagger and OpenAPI documentation at a local docs route so you can view all headers and fields directly in your browser. As a small extra touch, I can set up a quick mock data seed file so your initial test runs already contain a few dummy items when you spin it up. What port number do you prefer the local server to run on for your tests? Best, Salma Noreen
€22 EUR in 30 days
8.6
8.6

Hi, I can build a small, production-style REST API specifically suited for practicing API testing in Postman and Swagger, with clean validation, authentication and predictable responses. I’m an Expert Backend Developer with 8+ years of experience building REST APIs, JWT authentication, validation, documentation and database-driven applications. I can handle: JWT-based login endpoint with token generation Protected Create endpoint Request body validation and clear validation errors Sensible HTTP status codes and response structures Graceful exception and error handling OpenAPI 3.x documentation at /swagger or /docs Interactive request/response schemas and JWT authorization Simple PostgreSQL or in-memory storage with seed data Postman-friendly API structure and environment variables Clean source code and README with setup instructions I recommend Node.js with Express/NestJS, TypeScript and PostgreSQL for a realistic but lightweight implementation. The API will clearly separate authentication, validation, controllers and data access so you can easily extend it with additional CRUD endpoints later. I’ll also structure positive and negative test scenarios around authentication, validation, missing fields, invalid tokens and successful creation so the API provides useful coverage for your Postman practice. I can deliver a clean, documented foundation that is realistic enough for your portfolio without adding unnecessary complexity. Thanking you, All the very best, Cheers!!
€15 EUR in 40 days
7.9
7.9

Hi, I understand you need a small but realistic REST API for Postman and Swagger practice. I will build the login flow with JWT authentication, a protected Create endpoint, request validation, clear response formats, correct status codes, and clean error handling. I can use Java, Python, or PHP and include simple seed or in-memory data so the API returns useful results without unnecessary setup. I will document the endpoints with a valid OpenAPI 3.x specification at /swagger or /docs, including fields, headers, authentication, and success or error responses. I will also provide source code and a clear README covering installation, environment variables, login, token usage, and importing the API into Postman. The structure will be easy to extend when you add more endpoints later. Which language and framework do you prefer, and should the Create endpoint use products, articles, or contacts as its resource? I will keep the implementation focused, reliable, and suitable for your portfolio and automated positive and negative tests.
€21 EUR in 37 days
7.7
7.7

Hello, I can help you with "REST API for Postman Testing" as per your given project description. We can discuss more in detail during a chat conversation when you are available. I've worked on many PHP projects in recent times. So I am confident on achieving your expected Goals. Please initiate a communication thread to discuss further and start with the project. ⭐ 5.0/5 from a recent client: "Good work delievered thank you for your patience" Final timeline and cost will be confirmed in chat after a complete understanding and documentation of the project expectations in detail.
€12 EUR in 1 day
7.7
7.7

As an API development specialist with a strong background in Java, JavaScript, Node.js, PHP, and Python, I have the technical chops to deliver exactly what you need for your Postman testing. With over 14 years of experience and more than 300 projects completed with 99% positive reviews, my team at Walking Dreamz Technologies can offer you top-notch solutions that are future-proofed and extendable. What sets me apart is not just my technical skills but also my approach to projects. I believe in clear communication, clean code, and predictable delivery - all qualities which you mentioned are important to you as well. By choosing me for this project, you can expect direct access to me as your main contact ensuring there will be no communication gap. You can also rely on clear milestones, frequent demos and transparent progress updates. Lastly, let's not forget about the importance of post-launch support and documentation. A project is not complete just with the release; it extends beyond that. My commitment to providing production-ready deployments, documentation, and ongoing support will ensure that the work I do for your API will continue to serve you well into the future. Let's build something stable today that can effortlessly be built upon in the future. Let's collaborate on your rest API project together!
€12 EUR in 40 days
7.6
7.6

Hi sir, I read your project description .I can do your project & able to run successfully. I have 8+ years experience for website & mobile application development also done over 400+ project by a good team members . It will be very much pleasure for me, if you give me the opportunity to do your job for minimum cost. Thanks for your consideration . Thanks with Regards Prosanto
€15 EUR in 40 days
7.5
7.5

Hi, I’m Mayank, a full-stack developer with 12+ years of experience. I can build a small production-style REST API specifically for your Postman and Swagger testing practice. I’ll use Node.js + Express + PostgreSQL/in-memory storage with: * JWT login/authentication * Secure Create endpoint with validation * Proper status codes & error handling * OpenAPI 3.x at /docs * Seed/sample data * Postman-friendly environment setup * README with setup, env variables and JWT flow I’ll keep the API intentionally simple but realistic, so you can easily extend it with more CRUD endpoints later. Timeline: 2–3 days, including testing and documentation. Thanks
€12 EUR in 40 days
7.6
7.6

Hi, I can build the REST API you need as a clean, realistic foundation for Postman and Swagger/OpenAPI testing. I have 11+ years of professional software development experience, with strong expertise in Java, Spring Boot, Spring Security, REST APIs, JWT authentication, API validation, testing and API documentation. I would recommend: Java 17/21 + Spring Boot + Spring Security + JWT + OpenAPI 3.x ### What I will deliver * JWT-based login endpoint that issues an access token * Protected `Create` REST endpoint * Request DTO validation with clear validation messages * Proper HTTP status codes such as `201 Created`, `400 Bad Request`, `401 Unauthorized` and appropriate error responses * Global exception handling with consistent response bodies * Seed data / H2 or simple database storage * OpenAPI 3.x documentation with request/response schemas * Swagger UI accessible through the application * JWT authentication documented directly in Swagger * API examples suitable for Postman testing * Environment-based configuration for base URL and secrets * Clean layered project structure * README covering setup, configuration and JWT login flow * Source code ready for future CRUD endpoints and additional testing For example, the workflow can be: `POST /api/auth/login` → receive JWT → `POST /api/products` with `Authorization: Bearer <token>` → validate request → save record → return the newly created object with `201 Created`. I’m available to start immediately.
€14 EUR in 40 days
7.3
7.3

Hello, REST API + Swagger {{{ I HAVE BUILT SIMILAR REST APIs WITH JWT AUTHENTICATION, VALIDATION, ERROR HANDLING AND OPENAPI DOCUMENTATION BEFORE AND CAN SHOW RELEVANT WORK. }}} I have 11+ years of development experience and can build a clean production-style API with: • Login endpoint issuing JWT • Protected Create endpoint with request validation • Proper HTTP status codes and structured errors • In-memory/SQLite seed data • OpenAPI 3.x at /docs or /swagger • Postman-friendly environment variables • README with setup, JWT flow and testing instructions I can use Node.js/Express or FastAPI and deliver the complete source code with a simple, realistic data model. Thanks, Christina
€12 EUR in 40 days
7.7
7.7

I understand, we can build a small production-style REST API with JWT login, a protected Create endpoint, request validation, proper status codes, structured error handling, in-memory or seed storage, and complete OpenAPI 3.x documentation. We can also structure it cleanly for easy Postman testing, with clear environment variables and setup instructions. Related API and backend work is available on our profile. 1. Do you have a preferred stack, or should we choose one based on simplicity and clean Swagger integration? 2. What type of record would you prefer for the Create endpoint, such as products, contacts, or articles? 3. Should the API be deployed to a public test URL, or is local setup sufficient?
€15 EUR in 40 days
6.7
6.7

Hi there, I can help you build a well-documented REST API with a focus on your requested "Create" endpoint, implementing JWT authentication for security and validating requests effectively. I'll use a language of your choice to ensure the application meets production standards, including proper status codes and error handling. Additionally, I will provide an OpenAPI 3.x specification to facilitate your Postman testing, making sure the API is easy to import with environment variables for the base URL and token. I'll include a brief readme to guide you through the setup. Regards, Ali
€12 EUR in 1 day
6.6
6.6

Hi There , Good morning! I’ve carefully checked your requirements and really interested in this job. I’m full stack node.js developer working at large-scale apps as a lead developer with U.S. and European teams. I’m offering best quality and highest performance at lowest price. I can complete your project on time and your will experience great satisfaction with me. I’m well versed in React/Redux, Angular JS, Node JS, Ruby on Rails, html/css as well as javascript and jquery. I have rich experienced in REST API, JavaScript, Node.js, API Testing, PHP, Python, API Development, Java and Software Architecture. For more information about me, please refer to my portfolios. I’m ready to discuss your project and start immediately. Looking forward to hearing you back and discussing all details.. Feel free to contact us to discuss your project
€16 EUR in 32 days
6.6
6.6

Hi, I'm Denis, a full-stack developer who has built several REST APIs for testing and documentation purposes. I understand what you need—a clean, well-documented API that serves as both a learning tool and portfolio piece. Your approach is solid. You need a production-ready Create endpoint with validation, error handling, and proper status codes, protected by JWT authentication, and fully documented with OpenAPI for Postman integration. The login flow is the gateway; everything else flows from there. I'd build this with Node.js and Express for straightforward setup, documentation, and deployment. The structure is simple: a login endpoint that validates credentials and returns a JWT, then a Create endpoint that validates the JWT and request body, stores data in memory, and returns the created object with proper HTTP status codes. I'll add comprehensive Swagger annotations so every field, parameter, and response appears in the OpenAPI spec. The validation will be realistic—catching missing fields and type mismatches with appropriate 400 responses and clear error messages. The Create endpoint returns 201 Created with the full object, or 401 for invalid/missing tokens. This gives you genuine test scenarios. I'll include a README with setup instructions, required environment variables for Postman, and JWT retrieval guidance. The API will run locally and import into Postman immediately. I can start right away. Let's discuss the details. Thanks, Denis.
€15 EUR in 40 days
6.6
6.6

Hi there, For a Postman-testable showcase API I'd use Node.js with Express: swagger-jsdoc generates a live OpenAPI 3.0 spec from annotations, served at /docs via swagger-ui-express, so code and docs never drift. I'd split routes, controllers and validation middleware, wire a bearer-JWT securityScheme so Swagger's Authorize button injects the token, and return RFC 7807 Problem Details for clean 400/401/404 tests. I'm an independent full-stack developer in Switzerland—planning, code, testing and deployment in one pair of hands. Comparable builds: the Freelancer.com Automated Bidding and Project Ranking (Node.js, Python, REST API) and the AI Recommendation Chatbot for WooCommerce Shop (FastAPI, REST endpoints). Earlier at Spot Werbung AG I integrated booking and payment APIs in PHP with REST, XML and JSON. JWT expiry, auth middleware and deliberate error handling are what make or break a testable API, so I treat negative paths as first-class citizens and validate input in middleware of its own. Say the word and I'll deliver a running instance with seed data and a short README. Is the language choice entirely open? Damian Hunziker
€13 EUR in 3 days
6.9
6.9

Hello! I can create a clean REST API with JWT authentication and a protected Create endpoint I will implement validation proper status codes error handling and OpenAPI 3 Swagger documentation I will use PHP Laravel and simple storage with seed data so the API is easy to run and test in Postman I will also provide README with setup environment variables and JWT login instructions I have extensive experience with PHP REST APIs authentication and integrations $200 / 2 days
€45 EUR in 40 days
6.6
6.6

Hi, I can build the REST API foundation you need for Postman and Swagger practice, with a secured Create endpoint, JWT login flow, and clean validation/error handling. I’ll expose a proper OpenAPI 3.x spec at /docs or /swagger, add seed data or in-memory storage, and make sure the response bodies and status codes are production-style and easy to test in Postman. I’ll also include a brief setup read-me with environment variables and JWT instructions. Regards, Parvesh M.
€12 EUR in 21 days
6.3
6.3

Eindhoven, Netherlands
Member since Nov 5, 2025
₹1500-12500 INR
₹100-400 INR / hour
$30-250 USD
$250-750 USD
$250-750 USD
$250-750 USD
₹100-400 INR / hour
$10000-20000 AUD
$750-1500 USD
₹1500-12500 INR
$25-50 USD / hour
$15-25 USD / hour
$250-750 USD
$15-25 USD / hour
$2-8 CAD / hour
$10-30 USD
₹750-1250 INR / hour
£20-250 GBP
$200-400 HKD / hour
€12-18 EUR / hour