search

openaustralia / morph

Take the hassle out of web scraping
https://morph.io
GNU Affero General Public License v3.0
462 stars 74 forks source link

I expect the first url on the api page to be the one I can copy and use #710

Open equivalentideas opened 9 years ago

equivalentideas commented 9 years ago

When I go to use a scrapers api, I always immediately copy the first link on the 'How to use the api' page before realising that's the example and it doesn't change to match the scraper I'm looking at.

Not sure if this is just an issue for me.

We could make the first url dynamic as well as the one at the bottom of the page you currently use.

mlandauer commented 9 years ago

@equivalentideas I think that's excellent feedback. The first url is there to show you what parameters go where. The second url is live and gets filled in automatically.

The first url is really useful when you're developing an app that consumes the api. The second url is really useful to get a handle with a specific example to see how it works.

I think there's value in having both of those there. I think what's wrong and confusing is that they should both be near each other on the page and the difference between them made clear and explicit.