what is soap api and rest api code example

Example: when to use soap api

Use the SOAP API to create, retrieve,
update or delete records, like accounts
, leads, and user-defined objects.
With more than 20 different calls, 
you can also use the SOAP API to manage
passwords, perform searches, etc.
by using the SOAP API in any language 
that supports web services.