getSMARTFileDiff — Retrieving file diff of SMART File Scan results

The getSMARTFileDiff method retrieves the file diff of the SMART File Scan result. It can be used to provide detailed file changes since the last scan.

The API endpoint is:

https://api.sitelock.com/v1/partner

Request format

SiteLockOnlineRequest: This element is used to delineate the full API request.
- authentication: The partner’s username, password, and branding
  - username: The partner’s API username
  - password: The partner’s API password
  - partner: (Optional) The brand name to use in messaging
- getSMARTFileDiff: The method name
  - site_id: The ID of the site for which to retrieve the scan details
  - file_name: The name of the file for which to retrieve the diff
  - smart_scan_id: The ID of the SMART File Scan for which to retrieve the file diff

Example request

<SiteLockOnlineRequest>
    <authentication>
        <user>Username</user>
        <password>Password</password>
    </authentication>
    <getSMARTFileDiff>
        <site_id>9999999</site_id>
        <file_name>public_html/wp-data.php</file_name>
        <smart_scan_id>222222</smart_scan_id>
    </getSMARTFileDiff>
</SiteLockOnlineRequest>

Response format

SiteLockOnlineResponse: This element is used to delineate the full API response.
- getSMARTFileDiff: The method name
  - account_id: [attribute] - The ID of the user account
  - site_id: [attribute] - The ID of the site for which the results were retrieved
  - file: The file for which the results were retrieved
  - id: The ID of the file
  - diff: The diff of the file
  - direction: The value can be one of the following:
    
    in: The file was added since the last scan
    
    out: The file was deleted since the last scan
    
    unchanged: The file is the same, modified since the last scan
  - file_name: The name of the file for which the diff was retrieved
  - smart_scan_id: The ID of the SMART File Scan

Example response

<SiteLockOnlineResponse>
    <getSMARTFileDiff account_id="88888888" site_id="9999999">
        <file>
            <id>3771473</id>
            <diff>
                ____________________________________________________________________________________
                --- 2014-11-04 06:07:15 +++ 2014-11-23 04:01:24@@ -27,12 +27,7 @@ +
                                callback: function( pos ) \{ +
                -                      if ( isNaN( pos ) ) \{ +
                -                              pos = 0; +
                -                      } +
                                        var i = bullets.length; +
                -                      if ( i &amp;gt; 0 ) \{ +
                -                              while (i--) \{ +
                -                                      bullets[i].className = &amp;#39; &amp;#39;; +
                -                              } +
                -                              bullets[pos].className = &amp;#39;active&amp;#39;; +
                +                      while (i--) \{ +
                +                              bullets[i].className = &amp;#39; &amp;#39;; +
                                        } +
                +                      bullets[pos].className = &amp;#39;active&amp;#39;; +
                                }
                ____________________________________________________________________________________
            </diff>
            <direction>in</direction>
            <file_name>public_html/public_html/wp-data.php</file_name>
            <smart_scan_id>222222</smart_scan_id>
        </file>
    </getSMARTFileDiff>
</SiteLockOnlineResponse>