-5

Whenever I am asked to give a quote for a project that involves a remote REST API, I become very cautious.

Most of the REST API's I worked with had a documentation, but it usually turned out to be very basic (I may not need prose texts, but I don't have a crystal ball either), with the real complexity hidden somewhere and requiring long discussions with the API devs.

I shot myself in the foot several times already with this.

But clients, especially new ones, insist on a project budget.

I understand that all projects involving 3rd party software potentially have this problem. But it am under the impression that REST API devs are especially lazy with proper documentation, there is no source code that could provide you with clues, and there usually is no community for API's that are much smaller than Paypal or Amazon.

Since almost all new projects involve a remote REST Api of some sort, my question is: How do you deal with this?

Hans
  • 406
  • 1
  • 3
  • 13
  • I’m voting to close this question as off-topic because it is **[about](http://softwareengineering.stackexchange.com/tour)** giving a fixed project price – gnat Jul 24 '20 at 10:11
  • 1
    @gnat There are similar question revolving around how to sell certain development approaches to clients, so I'm not sure why those would be on topic, but not mine. – Hans Jul 24 '20 at 10:22
  • 1
    @gnat do you consider estimating the amount of work that goes into a feature part of the development process? – Rik D Jul 24 '20 at 11:12

1 Answers1

2

You deal with it, by keeping a history for yourself of your upfront estimates vs the real amount of time that went into developing something.

Let's say your estimates are on average 30% low, but on projects involving REST API's they are 50% low. With this knowledge, when a new request comes in, you estimate the amount of work and if there's a REST API involved, you increase your estimate with 50% and communicate that to the client.

Rik D
  • 3,806
  • 2
  • 15
  • 26
  • This is pragmatic, as long as I can keep track on how much longer I usually need on REST API projects. This means I have to probably miss the mark a few times before I can tell, which may not be helpful for someone just starting out with REST projects. – Hans Jul 24 '20 at 12:11