An application programming interface (API) is the specification for which software is meant to be used by other software.

learn more… | top users | synonyms

3
votes
1answer
292 views

Thread safe graph libraries

I am looking for a good Java Graph Library which is thread safe for concurrent access. JGraphT, JUNG, JTS are very good but again for concurrent access I will have to synchronize it externally which ...
3
votes
5answers
412 views

Is It OK to Develop Against a 3rd Party Library You Discover?

If you find out a way to interact with a web service API that is not publicly documented as available, and can emulate it within an application you develop, is it illegal to do so? Furthermore is it ...
0
votes
2answers
146 views

Is hooking Data access method on wrong object detrimental for a developer

In a simple application I am creating there are Admin and users where admin can create users. Right now I am creating Classes that encapsulate database CRUD calls with methods. For example: ...
3
votes
2answers
3k views

How to use a 3rd party web API

I am trying to understand the concept of using 3rd party web API. From what I understand so far, web API look like regular URLs with some parameters etc. Will the client program need to download and ...
1
vote
4answers
849 views

Why python library APIs are more intutive than C++ STL library APIs? [closed]

I am not sure whether it is a personal perspective or just a common feeling. I think in most cases, python's API is much more intuitive than C++ STL library APIs. If it is not a subjective judgement,...
3
votes
1answer
519 views

Find the average speed for roads

I am working on a mobile application and I would like to ask you a question. Is there an API or a method to get/calculate the average speed that a car should have in a road. I am working on a GPS like ...
8
votes
1answer
14k views

What is the best way to comment a deprecated class in Java?

I would like to know the best way to add a comment to identify a deprecated class in Java. Should I remove the previous comment added to the top of the class that helps another programmer to know what ...
6
votes
3answers
279 views

When you write wrappers for APIs how do you handle usage errors?

When you write wrappers for APIs how do you handle usage errors? Do you assume that the user uses it right and write the wrapper such that it makes the call to the server and let the server return ...
13
votes
6answers
2k views

How do you learn a language's standard framework/API/functionality? [closed]

I understand how to code. I know how to get around the basics of the languages I use regularly. I know how to write slightly-above-basic regular expressions, I can talk to databases, I can accept ...
1
vote
6answers
1k views

Java API vs. Other APIs [closed]

I'm more at the novice end of the software developer spectrum, but nevertheless I've had exposure to quite a few programming languages and frameworks. From all the technologies I've used, I haven't ...
5
votes
3answers
799 views

How should a web API handle misspelled/extra parameters?

Question: For a public facing web API(send HTTP Get/Post requests, get JSON/XML data back), how should parameters be handled that are either misspelled or are extra. It seems to me that if the ...
4
votes
2answers
358 views

What methods were used for online payments before API's and Paypal, etc

What methods (in programming/web dev terms) were used to take payments online before such things as Paypal, Google Checkout and various gateways and API's. How were such transactions carried out?
1
vote
1answer
298 views

Address validation service for a public website [closed]

Given the following scenario: There is a public website (with about 50-100 visitors a day) Visitors register for the services offered by the company who owns the website Visitors tend to give wrong ...
2
votes
2answers
248 views

Network application framework/API/etc

With all the web2.0 hype and webapps being all the rage, the only advantage from a corporate POV that I can think of webapps having is that it is easier to service your user base: upgrades become ...
0
votes
4answers
230 views

API naming and namespacing [closed]

Is it right or more beautiful to name the functions with an prefix, like in Qt? Or using "many" namespaces, but 'normal' names for functions? For example, slOpenFile(); //"sl" means "some lib" vs ...
0
votes
2answers
233 views

Looking for the fastest way to collect form data

I am developing an application in Flex. There are 20+ 'pages', each with its own form. I need to collect all the entered data and pass it to an API method. What I am wondering is when I should begin ...
5
votes
4answers
364 views

Is deprecating a real commitment?

If you deprecate something, are you guaranteeing you will get rid of it in the next major release? Is it reasonable to take two or three releases before you get rid of it completely? Update: ...
3
votes
1answer
284 views

Apache Wave API

I'd like to create an application based around Apache Wave. Where can I learn more about working with Apache Wave and/or the API for a locally running instance? At the moment, the extent of what I ...
4
votes
8answers
593 views

Doing 'more' with C on Windows than very simple programs?

I'm currently learning C via 'C Primer Plus' as recommended by a lot of people here and I'm finding it very interesting - the in-depth explanations of how and why we do certain things in C are great ...
2
votes
2answers
49 views

Terms of Service responsibility when developing a library service that wraps a 3d party API

For my own amusement and instruction I've been developing a C# / .NET library that is basically a wrapper around the Google Geocoding API. It simplifies the entire process and enables users to perform ...
2
votes
2answers
2k views

Facebook and Twitter authentication from Mobile Applications

I might be missing something with the Facebook and Twitter logins APIs. Something that is blocking me from understanding how they would be used in mobile applications. Both APIs seem like they need ...
1
vote
1answer
254 views

ChunkDB to handle high traffic JSON web service? Alternatives?

I am designing a high volume web service which will rely on a central database containing objects of a single JSON type. Currently I am considering using ChunkDB to store the objects and retrieve the ...
2
votes
3answers
667 views

Priority value meaning

The library that I'm working on has a parameter which defines priority of a certain process. I want the interface to be as clear as possible, but it seems that different people have opposite ...
2
votes
3answers
743 views

What should I name these methods? [closed]

I have two interfaces, one with and one without generic type parameters. The non-generic interface is used internally so that I can store instances of the generic interface in a collection. All would ...
3
votes
2answers
529 views

Strategy for designing a plugin API

I am working on an application for which a rich plugin API is crucial. What is the best process for creating an API that is intuitive and easy to learn?
3
votes
1answer
406 views

API Design Question

I am currently designing a API and have come to a slight design issue and was hoping for a few other opinions. My url structure for accessing basic data from the API is: /clientName/appName/...
3
votes
3answers
620 views

What is the best way to implement different views of one resource in RESTful manner?

Imagine, there is a resource, for example event. User is able to get list of events in HTML format. He should be able to view that list in two ways: as a list and as a calendar. How the API should ...
5
votes
1answer
600 views

Application internal API

I am currently building a small python CLI (Command Line Interface) application with ambition. In the first development phase I would concentrate on making it work through the CLI interface only, but ...
0
votes
1answer
98 views

User directory - framework

I'ld like to create a very basic directory where user can enter their social network profiles and pick a username. From that data a little website gets generated. The sign in process should be managed ...
1
vote
1answer
365 views

Translating error messages from an external API?

If I am localizing a piece of software that uses an external API, how should I handle error messages that originate in this API? I do not control the API, I only consume it. The error responses are ...
4
votes
2answers
1k views

What are the best patterns/designs for stateful API development?

I am about to implement a API for my TCP/IP server written in Java. Right now I have a temporary method that takes a String, executes a command based on the String and returns a String basically like ...
13
votes
6answers
5k views

Are Java's public fields just a tragic historical design flaw at this point? [closed]

It seems to be Java orthodoxy at this point that one should basically never use public fields for object state. (I don't necessarily agree, but that's not relevant to my question.) Given that, would ...
10
votes
4answers
1k views

How are undocumented functions discovered? [closed]

I've always wondered how do you find undocumented / private API ? Example the Apple undocumented / private API, Play Station, Windows Phone 7, Win32 Kernel, Windows API, hidden callback, etc... ...
11
votes
4answers
2k views

Evolution of the Win32 API [closed]

Has the Windows 32 API changed much over time? Does the Charles Petzold book "Programming Windows, 5th Edition" from 1998 still contain relevant information, or is most of it obsolete/outdated? What ...
2
votes
1answer
445 views

Question about API and Web application code sharing

This is a design question. I have a multi part application with several user types. There is a user client for the patient that interacts with a web service. There is an API evolving behind the web ...
5
votes
2answers
3k views

Determining Cost of API Calls [closed]

[This is a cross-post originally posted by me in SO. I think the question is more appropriate here.] I was going through the adwords API and came across their rate sheet - http://code.google.com/apis/...
2
votes
1answer
279 views

How to define template directives (from an API perspective)?

Preface I'm writing a template language (don't bother trying to talk me out of it), and in it, there are two kinds of user-extensible nodes. TemplateTags and TemplateDirectives. A TemplateTag ...
9
votes
3answers
1k views

Balancing dependency injection with public API design

I've been contemplating how to balance testable design using dependency injection with providing simple fixed public API. My dilemma is: people would want to do something like var server = new Server()...
3
votes
1answer
145 views

Legal aspects of Java specification implementations in other programming languages

I am planning to implement an official Java specification in a different programming language. Would this be a copyright violation? Hypothetical examples: a JMX "wrapper" library for C++ which can ...
5
votes
2answers
634 views

API/Technical Writers Guide [closed]

Is there any good book/tutorial/guide for programmers, which can help them to write good programming documentation/tutorials/guides?
4
votes
1answer
1k views

Concepts: API Level Testing

I'm college grad, soon to be graduating. SO i have started my job search. So my question is for New Grad who is interested in QA (API Level testing in particular). What is level of knowledge in JAVA ...
7
votes
8answers
1k views

Examples of Java APIs that demand an action sequence

As part of a research I'm working on, I'm looking for public APIs that only work correctly when you apply a certain sequence of actions on them. For example, the java.nio.channels.SocketChannel class,...
9
votes
6answers
415 views

What core principles would you want in a library?

Theres talk about what syntax and feature you like in a programming language; i'll now ask what core principles or feature would you like in a library in your favorite (or any) language? An example ...