Field API Intro Labs Overview

I have done “Intro Labs” series for some products’ API in the past. Occasionally I was asked if there is a similar one for Field API or planning to make one. So here it is. I’m going to write about the introduction to Field API in the next few posts.

That being said, I should add a disclaimer before I proceed with writing; Field API is still under discussion about its supportability. We don’t have good documentation and samples, yet. For example, there is no comprehensive API samples like SDK Test Harness or Sample Web App for Glue. You will probably find some discrepancy in the current online documentation. (There is some historical reasons that we have the API which supports a certain set of functionalities. But this will be a different discussion.) We hope this will improve as the API matures in future. For the time being, we appreciate your patience.

Enough is said, let’s talk about the labs. The intro labs are intended to be exercises to learn Field API for people who is new to the File API. (If you happen to have used Glue API Intro, and View and Data API Intro labs that I wrote, the idea is exactly the same. In fact, I’m following the same format.)

The labs include four incremental code projects. Starting from Lab 1, we learn the basics of Field API:

Note that the last lab’s reporting functionality is not a part of Field API itself. I added this as I hear that reporting or “health monitoring” of a project is one of commonly discussed use case of Field API. (Apart from that, it also adds colors to the lab 🙂

All projects are minimum for clarity and focusing on understanding the logic of Field API for learning purposes. They are written in C#, ASP.NET. After the Lab4, the final application looks like below:

20150402_FieldApiIntroLabs_Overview

You can download the source code from here: Download Field API Intro Labs

Additional References:

Here are a few links about Field API as reference. You may want to take a look to get a big picture:

 

Next: Lab1 “Hello Field World”

Mikako

Advertisements

2 thoughts on “Field API Intro Labs Overview

  1. Daniel Scott

    Hey Mikako!

    These labs look amazing, however I am severely stuck on step one: logging in. And I have no idea why, despite using exactly the same login details as I do on the field website directly all I get is the response: Status Code: Unauthorized {“ticket”:null,”message”:””,”title”:””} (I’ve also had other people try there logins, including admin, no joy).

    I appreciate that these labs are well over a year old but what be thankful for any advice!

    Like

  2. Hi Daniel,

    For troubleshooting, I would approach by testing REST call itself first by using a tool like Postman: https://www.getpostman.com/
    I wrote a blog about this tool, too:
    https://fieldofviewblog.wordpress.com/2015/03/24/tools-for-testing-rest-api/
    UI looks different now. But it’s quite intuitive how to use it. I cannot attach an image to this comment. So I will send it to you separately.

    Once you verify that login works on postman, the problem is in your code (or my code if you are using the same project). Field API is REST, meaning that it has nothing to do with binary or build for Field web services. Login hasn’t changed. Please try it.

    Also, for trouble shoot time discussion, Forum or Stack Overflow is more suited. I would appreciate if you use those. Sorry that things are less clear. Something we need to improve. In a mean time, I hope finally you are on the right community at least.

    Like

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s