Förberedelser

  • Ladda ner och installera POSTman app.
  • Skaffa ett konto: 46elks.
  • En live server att köra PHP på. Skicka ett SMS med ditt namn till +46766865445 för att få tillgång till vår workshop server

Vad är ett API och när är det relevant att använda APIer?

  • Tillgängliggöra data
  • Automation
  • Lager som täcker komplexitet

Terminologi

Dessa begrepp kommer du att bekanta dig med under workshopen:

  • url
  • request
  • response
  • status codes
  • docs
  • GET & POST
  • Authentication
  • format (json, xml, other)
  • PHP
  • Live server
  • Vim
  • Öppna data
  • www-formurl-encoded

Du kommer lära dig!

Vi går igenom terminologi och förkortningar du inte hört tidigare, och det är poängen.
Du är med på workshopen för att lära dig. Ställ gärna frågor medan workshopen pågår!

Du kommer lära dig hur APIer fungerar genom att använda ett API på riktigt.

Sammanfattning

URL

Adressen. Du har en hemaddress.
APIer har också egna hemadresser på internet. Precis som hemsidor.
Exampel: https://api.46elks.com/a1/SMS

När & varför använda APIer?

hjälp!?

  • Kontakta dem som tillhandahåller APIet
  • Stackoverflow ofta en räddare
  • Andra människor - gå på meetups, hackathons, besök olika forum... det är lättare att komma vidare när det finns andra som kan hjälpa dig
  • Du kan också söka på API reference manual, API documentation, API docs eller API manual för att hitta mer information.

Request

  • GET Be om data.
  • POST Skicka in data. Trigga en händelse.

Status codes

  • 200 Allt väl.
  • 404 Vi hittar inte det du letar efter!
  • 20x OK!
  • 30x Någon annanstans!
  • 40x Du gör fel. Läs i dokumentationen (som också kan kallas manual, docs, API reference, kärt barn har många namn). Be om hjälp!
    Exempel: https://46elks.com/dennasidafinnsinte - 404.
  • 50x Hoppsan! Vi verkar ha gjort bort oss (vi har gjort fel!). Berätta gärna vad som strular eller försök igen senare.
  • http cat ett bra ställe att lära sig alla status koder.

Format

json


    


    

XML


    

Authentication

  • Credentials
  • API key
  • Basic auth

Skicka SMS med PHP

Logga in på servern

  • Logga in på servern med sina credentials som en fick i SMS:et Byt ut username till det användarnamn som du fick i SMS:et
  • 
            
  • Ange lösenordet i SMSet
  • För att starta servern kör nedan men byt ut 500 till den port du blivit tilldelad
  • 
            
  • Då är servern nåbar på URL:en http://64.225.108.133:5000
    Byt ut 500 till din port
  • Vill du stänga av servern kör du ctrl + C

Skriva PHP koden

  • Skapa en fil igenom att köra vim send-sms.php
  • Tryck I för Insert mode
  • Nu till själva koden, kopiera nedan och klistra in i din fil
  • 
            
  • Ändra username och password till dina egna API credentials, du hittar dem här
  • Ändra variablerna from, to och message till det du vill använda i ditt SMS
  • För att spara filen kör ESC + :wq
  • Start servern och gå in på URL:en http://64.225.108.133:5000/send-sms.php

Vill du hitta fler kodexempel?

Fler kodexempel i många olika programmeringsspråk hittar du på GitHub eller våra tutorials här