APIHQ - interaktiv API-dokumentation

Det kan vara en hög tröskel att komma igång med ett API. Bara för att experimentera lite så krävs ofta att man registrerar sig, ansöker om en API-nyckel, tröskar igenom dokumentation och kodexempel för att slutgiltigen skriva kod som använder APIet. Alla dessa steg gör att många utvecklare inte börjar använda ett API och det skrämmer bort alla som inte är programmerare. Så hur får vi icke-programmerare att förstå vad ett API kan göra och hur lockar vi fler programmerare att använda ett givet API?

Testa ett API direkt i webbläsaren
Med API-konsolen från APIHQ så kan man börja använda ett API direkt i en webbläsare, utan att först läsa dokumentation, fixa API-nycklar eller skriva en rad kod. Det är helt enkelt interaktiv API-dokumentation där man anropar ett API genom att fylla i ett formulär. Man får en bra översikt på vilka metoder och parametrar ett API har och hur APIet fungerar.

Svaret på ett API-anrop visas snyggt formaterat så att man enkelt kan se vad APIet returnerar för data. Man kan också se svaradata helt oformaterat med alla HTTP-headers om man föredrar det.

Fördelarna för programmerare som vill använda APIet är att det går att komma igång med att testa ett API på sekunder. Fördelarna för de som publicerar APIer är att fler programmerare kommer igång med APIet, vilket i sin tur ökar chanserna till att en killer-app utvecklas och att APIet blir en stor succé.

Behöver ditt API en API-konsol?
Än så länge är APIHQ endast öppet för utvalda APIer, tex:
Kundo, Flattr och landstäckande Resrobot reseplanering. Snart kommer vi att öppna portarna för alla som har ett API att skapa en egen API-konsol, men om du känner att du behöver en API-konsol NU så är det bara att maila.

Mer information finns på APIHQ.com. Följ oss gärna på Twitter för nyheter om APIHQ och gott om matnyttiga API-tips.

/Andreas Krohn, Mashup.se