{ Community }
  • Academy
  • Docs
  • Developers
  • Resources
    • Community Articles
    • Apigee on GitHub
    • Code Samples
    • Videos & eBooks
    • Accelerator Methodology
  • Support
  • Ask a Question
  • Spaces
    • Product Announcements
    • General
    • Edge/API Management
    • Developer Portal (Drupal-based)
    • Developer Portal (Integrated)
    • API Design
    • APIM on Istio
    • Extensions
    • Business of APIs
    • Academy/Certification
    • Adapter for Envoy
    • Analytics
    • Events
    • Hybrid
    • Integration (AWS, PCF, Etc.)
    • Microgateway
    • Monetization
    • Private Cloud Deployment
    • 日本語コミュニティ
    • Insights
    • IoT Apigee Link
    • BaaS/Usergrid
    • BaaS Transition/Migration
    • Apigee-127
    • New Customers
    • Topics
    • Questions
    • Articles
    • Ideas
    • Leaderboard
    • Badges
  • Log in
  • Sign up

Get answers, ideas, and support from the Apigee Community

  • Home /
  • General /
avatar image
2
Question by phathaway · May 04, 2016 at 08:48 PM · 235 Views docs

My Experience using Apigee Edge so far. No question. Just sharing my experience...

The Apigee docs invite me to share my experience, which links to here. My experience so far is that I am dependent on their tutorials to not only learn how to use apigee but also WHY anyone would bother using it (and paying for it). Their tutorials have you setup an API proxy with the UI, then the next step tells you that its out of date and it expects that the previous step had your proxy work with Yahoo Weather, which it didn't...so you can't go further in the tutorials because they don't make sense. The samples also use Yahoo Weather but I get responses about invalid credentials and the samples' docs don't provide further insight...making them worthless. No questions. Just my experience. Which apigee invited me to share.

Comment
Add comment
10 |5000 characters needed characters left characters exceeded
▼
  • Viewable by all users
  • Viewable by Apigeeks only
  • Viewable by the original poster
  • Viewable by moderators
  • Viewable by moderators and the original poster
  • Advanced visibility
Viewable by all users

Close

5 Answers

  • Sort: 
avatar image
2

Answer by Dino   · May 04, 2016 at 11:26 PM

Thanks for sharing the experience. I'm sorry it sounds like you had a frustrating time of it.

I'd love to be able to help you out, if you're interested.

I am dependent on their tutorials to not only learn how to use apigee but also WHY anyone would bother using it (and paying for it).

Is this a problem? What we try to do with the tutorials is provide materials that help people understand the product, what it can do, how to use it, and what problems it solves. From the way you've written this statement, it seems like you're not pleased about that part. But I think it's our goal.

Their tutorials have you setup an API proxy with the UI, then the next step tells you that its out of date ...

Hmm, I'd really like to understand that better. Can you describe the specific steps you went through, and what you saw? It sounds like it was a surprise, and not in a good way. Interested in troubleshooting it?

...and it expects that the previous step had your proxy work with Yahoo Weather, which it didn't.

OK,it sounds like you experienced another problem. I'm sorry you had the trouble. Maybe if you can describe exactly what you're trying, we can diagnose that specific step. I know you mentioned "tutorials", but specifically what tutorial are you following? Can you link to a web page or set of steps you're going through?

The samples also use Yahoo Weather but I get responses about invalid credentials and the samples' docs don't provide further insight...making them worthless.

I think that Yahoo's weather API has recently been changed. Specifically it now has a different security requirement. We (Apigee) used Yahoo's Weather API repeatedly, in many different examples, and that change in the underlying API has affected all these examples. We've tried to update all of them. It sure sounds like we've missed one, or not updated one. And you're getting tripped up by that mistake of ours. Give me the url and I'll make sure to get it updated.

Comment
Add comment Show 1 · Link
10 |5000 characters needed characters left characters exceeded
▼
  • Viewable by all users
  • Viewable by Apigeeks only
  • Viewable by the original poster
  • Viewable by moderators
  • Viewable by moderators and the original poster
  • Advanced visibility
Viewable by all users
avatar image Anil Sagar @ Google ♦♦   · May 05, 2016 at 05:38 AM 0
Link

@phathaway , Thank you for highlighting same and sharing your experience. We completely agree with you & understand how frustrating it is to get stuck at first few minutes of getting started with Apigee documentation.

@Dino , Only Part 1 in Getting Started has right resources to create API proxy. Part 2 onwards they refer to old weather API Proxy. Doc pages, Add Policy, Trace API calls, Monitoring, Create your First API XML , Secure APIs, refer to old weather proxy example.

avatar image
2

Answer by Sunandita Dam   · May 05, 2016 at 05:27 AM

Somehow my experience has been different. I started working on Apigee around 7 months back. I did not attend any specific training before starting work on apigee, I just refered the online documentation and ran sample examples which are readily available, to learn Apigee. I must say Apigee documentation is really well organized and has helped me great deal to understand and learn apigee faster.

Comment
Add comment Show 1 · Link
10 |5000 characters needed characters left characters exceeded
▼
  • Viewable by all users
  • Viewable by Apigeeks only
  • Viewable by the original poster
  • Viewable by moderators
  • Viewable by moderators and the original poster
  • Advanced visibility
Viewable by all users
avatar image Anil Sagar @ Google ♦♦   · May 05, 2016 at 05:42 AM 0
Link

@Sunandita Dam , Thank you for sharing your experience. Recently, docs have been affected due to change of yahoo weather proxy.

@phathaway got very valid points, At present getting started documentation is not complete due to change in yahoo weather proxy endpoint which makes documentation not useful as earlier. We are working on same & soon we will fix same.

avatar image
1

Answer by jonesfloyd · May 05, 2016 at 03:32 PM

@phathaway - Apologies for the snag. I'm in the process of updating the tutorials with the new sample target @arghya das mentions (the one in the very first tutorial). I should have it done within the next few days. Thanks for your patience, and thanks for taking the time to write in!

Comment
Add comment · Link
10 |5000 characters needed characters left characters exceeded
▼
  • Viewable by all users
  • Viewable by Apigeeks only
  • Viewable by the original poster
  • Viewable by moderators
  • Viewable by moderators and the original poster
  • Advanced visibility
Viewable by all users
avatar image
0

Answer by arghya das · May 05, 2016 at 05:33 AM

@phathaway Looks like the concern is around out dated tutorials and samples that do not work any more. Like @Dino mentioned the Yahoo Weather API was recently deprecated, its no longer a public API and requires authentication. I wrote a post on that specific issue.

So we decided to host our own API endpoint and the docs team has been working on updating the samples and tutorials accordingly. If you can point out specific sections of the tutorials or samples that have issues, we can address them.

Comment
Add comment · Link
10 |5000 characters needed characters left characters exceeded
▼
  • Viewable by all users
  • Viewable by Apigeeks only
  • Viewable by the original poster
  • Viewable by moderators
  • Viewable by moderators and the original poster
  • Advanced visibility
Viewable by all users
avatar image
0

Answer by wchuei · Jun 05, 2017 at 06:31 PM

Thank you for your inputs. In addition to the responses provided, we'll also be sure to incorporate your feedback into our other self service materials we're planning later this year

Comment
Add comment · Link
10 |5000 characters needed characters left characters exceeded
▼
  • Viewable by all users
  • Viewable by Apigeeks only
  • Viewable by the original poster
  • Viewable by moderators
  • Viewable by moderators and the original poster
  • Advanced visibility
Viewable by all users

Follow this Question

Answers Answers and Comments

26 People are following this question.

avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image

Related Questions

Offline Apigee Docs? 1 Answer

API products vs API packages 1 Answer

Thread protection policy documentation in section [Threat protection error configuration] 2 Answers

  • Products
    • Edge - APIs
    • Insights - Big Data
    • Plans
  • Developers
    • Overview
    • Documentation
  • Resources
    • Overview
    • Blog
    • Apigee Institute
    • Academy
    • Documentation
  • Company
    • Overview
    • Press
    • Customers
    • Partners
    • Team
    • Events
    • Careers
    • Contact Us
  • Support
    • Support Overview
    • Documentation
    • Status
    • Edge Support Portal
    • Privacy Policy
    • Terms & Conditions
© 2021 Apigee Corp. All rights reserved. - Apigee Community Terms of Use - Powered by AnswerHub
  • Anonymous
  • Sign in
  • Create
  • Ask a question
  • Create an article
  • Post an idea
  • Spaces
  • Product Announcements
  • General
  • Edge/API Management
  • Developer Portal (Drupal-based)
  • Developer Portal (Integrated)
  • API Design
  • APIM on Istio
  • Extensions
  • Business of APIs
  • Academy/Certification
  • Adapter for Envoy
  • Analytics
  • Events
  • Hybrid
  • Integration (AWS, PCF, Etc.)
  • Microgateway
  • Monetization
  • Private Cloud Deployment
  • 日本語コミュニティ
  • Insights
  • IoT Apigee Link
  • BaaS/Usergrid
  • BaaS Transition/Migration
  • Apigee-127
  • New Customers
  • Explore
  • Topics
  • Questions
  • Articles
  • Ideas
  • Badges